**************************************************************************
* Turboprint for Linux - a printer driver system for Linux
* (c) ZEDOnet 2000-2004, all rights reserved
*
* ZEDOnet
* Meinrad-Spieß-Platz 2
* D-87660 Irsee
* Germany
* WEB: http://www.turboprint.de
* EMAIL: mail@turboprint.de
**************************************************************************

TurboPrint for Linux Version 1.9
================================

HTML manual: doc/html/turboprint.html

Manuals for the shell based configuration tools:
doc/tpsetup.txt doc/tpconfig.txt 

See also INSTALLATION for installation details and a description
of archive contents.

Please use the form BUGREPORT for reporting errors.


A quick installation and usage / troubleshooting guide:
------------------------------------------------------

You must be logged in as "root".

Make this directory the current directory.

If you have a key file, please copy it to the installation directory.
Make sure that it is named "turboprint.key". A keyfile can be installed
later using xtpsetup or the command line "tpsetup --install turboprint.key".

Start the installation script "./setup".

  Note: To update from a previous version of TurboPrint, also
  use the "setup" script. You don't have to uninstall the
  older version of TurboPrint.

  If you add a keyfile, the "setup" script must be started again.

  If you switch your Linux system to the "CUPS printing system"
  the "setup" script must also be started again.

Add a new printer queue:

- Start "xtpsetup" to add a new printer:

  Press "Add" to add a new printer
  Choose the printer from the list
  Press "Ok" to accept the printer
  In the "Edit Printer" menu: change the port if necessary
  Press "Ok" to accept the settings for the new printer
  You are asked if you want to print a test page now - choose "Yes" or "No".
  Press "Ok" in the main menu.

- Alternatively, use "tpsetup":

  Enter "A" to add a printer
  Then "A" to add a new printer
  Choose your printer (enter one of the listed numbers)
  Change the port if necessary (default is /dev/lp0)
  Remember the "short name" - it is tp0 for the first added printer
  Enter "Q" to return to the main menu
  Then "S" to save.

- Test the printer by printing testpage-a4.ps or testpage-letter.ps:
  enter

    lpr -Ptp0 testpage-a4.ps

  tp0 must be replaced by the actual short name of the printer.

If everything is okay, your printer should soon start printing the
test page. You may now try the "xtpconfig" menu where additional
settings for your printer are available.

What to do if there is no output or only garbage on the page?

To see how testpage-a4.ps looks, you can enter 

  gs testpage-a4.ps

If that fails, you must install the ghostscript package first.
 
If nothing happens or you get an error message, you can
execute the print job manually (bypass the lp print spooler):
Attention: This doesn't work if the CUPS printing system is installed

  turboprint -Ptp0 testpage-a4.ps output.prn

This converts the document "testpage-a4.ps" to the printer file
"output.prn" using the configuration of the printer queue "tp0". 

You should at least get some messages. If everything seems
okay and output.prn contains data, you can send it to the printer
by entering

  cat output.prn >/dev/lp0

where /dev/lp0 must be replaced by the actual device that the
printer is connected to.

If that works as well, turboprint is correctly installed but there
is some problem with lpr. Please consult the lpr & printcap 
manpages and see if you can get a simple printer queue working.