# $ApsCVS: src/apsfilter/INSTALL,v 1.21.2.2 2001/03/20 00:20:25 andreas Exp $

APSFILTER installation instructions
===================================

For all Unix systems you need:

	* the spooling software (lpd, lpr, lprm etc.); apsfilter supports
	  BSD-style spoolers and LPRng (which in turn is BSD compatible)

	* for non-PostScript printers: ghostscript (gs) version 5.50 (GNU),
	  6.01 (Aladdin), 6.50 or greater

	* recommended: the psutils package (psnup, psselect, psbook, ...)

	* a converter for every file format that you want to print
	  for bitmap images:
		- convert  from the ImageMagick package  or
		- nconvert  from XnView  or
		- the pbmplus / netpbm tools
	  for ASCII files:
		- a2ps  or
		- mpage  or
		- recode (no fancy features, plain text)
	  plus
		- dvips  for DVI files
		- transfig  for XFig files
		- html2ps  for HTML files
		- sk2ps  for Sketch files
		- groff  for *roff files
		- optional: acroread or pdftops  for PDF files

	* compression tools if you want to handle packed files:
		gzip, bzip2, compress, freeze, pack



Installation procedure:
=======================

	* login as root

	* cd into a directory of your choice (can be shared between networked
	  machines); common location: /usr/local/share

	* extract the tarball; this will create a subdir "apsfilter"

		# gzip -cd apsfilter-x.y.z.tar.gz | tar xf -
	  or
		# bzip2 -cd apsfilter-x.y.z.tar.bz2 | tar xf -

	* cd into "apsfilter"

	* (optional) copy the contributed uniprint driver profiles into the
	  ghostscript lib directory; e.g.

		# cp uniprint/*.upp /usr/local/share/ghostscript/6.01/lib

	  This step can be skipped for FreeBSD users if the gs port has been
	  updated lately.

	* read the documentation

	* again: read the whole documentation, including the FAQ

	* to install printers, start the SETUP script and follow the
	  instructions:

		# ./SETUP

	* print some files as a final test

	* in case of a problem, read the apsfilter handbook
	  (doc/handbook.html), man pages for apsfilter, the
	  FAQ in the apsfilter handbook.
	  HOWTO-BUGREPORTS tells you, how to report bugs.

	* One final important note:
	  Please write bug reports to the mailing-lists not to
	  the developers personally.
	  Only this assures, that we can share our experiences
	  among apsfilter users and feed our browseable and
	  searchable mailinglist archive.
	  Thanks !

