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

Installation of TurboPrint for Linux 1.9
========================================

After unpacking the turboprint archive you should have the
following files in your directory:

  setup uninstall README INSTALLATION BUGREPORT CHANGES
  system.cfg test*.ps

And the following directories:

  doc bin lib printers colors dump


setup is a shell script that installs TurboPrint on your computer
-----
Important: 

* To start the setup script, enter "./setup". 

* You must be logged in as "root" and the current directory
  must be the directory of the setup script.

* Also use "setup" to UPDATE a previous version of TurboPrint.
  You don't have to run "uninstall".

* If you switch to the CUPS printing system, you must run "setup" again.

setup will list the installation settings from system.cfg and
ask you whether to proceed. Please type "y" to continue with
installation.

The next step will be to run "xtpsetup" or "tpsetup" to setup your 
printer(s).
Please see the HTML online manual (doc/html/turboprint.html)
or the tpsetup manpage for details.


uninstall is a shell script that removes TurboPrint from your computer
---------
Note for this release: The spool directories (usually in
/var/spool/lpd), the modifications in /etc/printcap and the
logfiles /var/log/turboprint.log will not be removed.


system.cfg is a text file that describes your system configuration 
----------
It tells the setup script (and later the TurboPrint software)
where to install the files and which permissions to use
for the spool directories - please see the description later in
this document.


testpage-a4.ps testpage-letter.ps testmargins-a4.ps testmargins-letter.ps
-------------------------------------------------------------------------
These are postscript test documents. Testpage contains test & color
graphics to test if the printer & driver are working properly.
Testmargins is for testing the unprintable page margins on A4 or
Letter sized paper.

Usage e.g.: lpr -P<printername> testpage-a4.ps


doc contains documentation and the HTML manual doc/html/turboprint.html
---

bin contains executable files
---

lib contains shell scripts
---

printers contains printer description files
--------

colors contains color correction tables
------

dump contains files that are sent directly to certain printers
---- (for use by printer drivers)

Required packages
=================

LPR or LPRng or CUPS printer spooler must be installed. 

GTK+ 1.2 must be installed for the GUI config tools xtpsetup/xtpconfig.

Ghostscript (version 4.03 or higher) must be installed to print
Postscript, PDF and most other file formats.

The following packages are required if the LPR(ng) spooler is
used instead of the CUPS printing system:

a2ps or enscript must be installed to print ASCII text.

The following packages are required for certain file formats:

fig2dev   - fig drawings
dvips     - TeX DVI documents
groff     - troff documents, e.g. man pages
html2ps   - html documents
bmptoppm  - BMP images
tifftopnm - TIFF images
giftopnm  - GIF images
djpeg     - JPEG images
rasttopnm - Sunraster images


The system.cfg file
===================

These are the default values. Please note that the comment
lines (that start with #) are not present and not allowed
within the actual system.cfg file.

TP_CUPS=1
 # add this line to choose a spooling system (0 for LPR/ng, 1 for CUPS)
 # if this line is not present, the setup program will autodetect
 # the spooling system
TPBIN_BROWSER=kdehelp
 # the help browser called from xtpsetup and xtpconfig
TPFILE_PRINTCAP=/etc/printcap
 # location & name of the "printcap" file
 # that is used by the lpr printer spooler
TPPATH_CONFIG=/etc/turboprint
 # where TurboPrint should store its configuration files
TPPATH_SHARE=/usr/share/turboprint
 # where TurboPrint should store its read-only files
 # (printer descriptions, color profiles)
TPPATH_SPOOL=/var/spool/lpd
 # where spool directories should be created
TPPATH_BIN=/usr/bin
 # where to store executables
TPPATH_FILTERS=/usr/share/turboprint/lib
 # where to store scripts
TPPATH_DOC=/usr/share/turboprint/doc
 # location for documentation
TPPATH_LOG=/var/log
 # location for log files
TPPATH_TEMP=/tmp
 # location for temporary files
TPPATH_MAN=/usr/man
 # location for manpages
TPPATH_CUPSDRIVER=/usr/share/cups/model
 # where printer descriptions files (.ppd) for cups are stored
TPPATH_CUPSFILTER=/usr/lib/cups/filter
 # where filter programs for the cups printing system are stored
TPOWN_SPOOLDIR=lp
 # owner of spool directories
TPMOD_SPOOLDIR=0755
 # permissions of spool directories
TPOWN_SPOOLFILE=lp
 # owner of files within spool directory
TPMOD_SPOOLFILE=0640
 # permissions of files within spool directory

The only lines that might have to be changed are
TPBIN_BROWSER, TPPATH_MAN

and in certain cases
TPOWN_SPOOLDIR, TPMOD_SPOOLDIR, TPOWN_SPOOLFILE, TPMOD_SPOOLFILE.

Linux distributions with LPRng spooler (e.g. RedHat, Mandrake, Caldera):
------------------------------------------------------------------------ 
Spooldir owner & permissions will be corrected automatically.
You don't have to change system.cfg.

===========================================(end of file)========