# $ApsCVS: src/apsfilter/INSTALL,v 1.27.2.4 2006/07/09 15:54:22 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 6.51 (GNU),
	  7.00 (AFPL) or later

	* 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 archives (will print file listing):
		ar, arc/unarc, unarj, cabextract, cpio, lha, rar/unrar,
		rpm, tar, unzip, zoo
	  for ASCII files:
		- a2ps  or
		- mpage  or
		- enscript  or
		- recode (no fancy features, plain text)
	  plus (depends on your special demands)
		- dvips  for DVI files
		- transfig  for XFig files
		- html2ps or htmldoc  for HTML files
		- sk2ps  for Sketch, WMF and XFig files
		- groff  for *roff files
		- tgif  for Tgif files
		- wmf2eps  for Windows Metafiles
		- optional: acroread or pdftops  for PDF files

	  for Audio files:
		- mpg123, mpg321 for playing mp3 files
		- vorbis-tools (ogg123) for playing Ogg Vorbis files
		- wavplay for playing wav files

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


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

	* 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"

	* configure apsfilter

		$ ./configure

	  You might want to give options; see "./configure --help"

	* login as root ("su -")

	* install apsfilter

		# make install

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

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

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

	* read the apsfilter documentation under doc/ subdir

	* again: please try to read the whole documentation, including the FAQ

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

		# /usr/local/share/apsfilter/SETUP

	  (adjust the path if needed)

	* restart the spooler daemon "lpd", mostly by typing as root:
		# lpc restart all

	* print some files as a final test

	* in case of a problem, re-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 note:
	  PLEASE WRITE BUG REPORTS TO THE MAILING-LISTS NOT TO
	  THE DEVELOPERS PERSONALLY.
	  This assures
	  - that we can share our experiences among ALL apsfilter users and
	  - feed our browseable and searchable mailinglist archive.

	  Thanks !