#	$Id: INSTALL,v 1.2 1999/02/18 21:15:08 andreas Exp $

Easiest Installation on FreeBSD, NetBSD and OpenBSD systems
===========================================================

	by using the FreeBSD ports collection:

	# cd /usr/ports/print/apsfilter
	# make all install clean

More info on this:

	http://www.FreeBSD.org/ports

Other systems
=============

PREREQUISITES:

	- Unix system with Berkeley-like (BSD) print system
	  (lpr, lpd, /etc/printcap), i.e.: FreeBSD, *BSD, BSD/*,
	  Linux, SunOS 4.1, Solaris 1, ...

	- C-Compiler (either GNU or your systems C-Compiler)

	- gs (ghostscript) Postscript emulator (only for non-PS printer)

	- optional the following compression programs 
	  to use all of apsfilter's decompressing features:
		gzip, freeze, compress

	- optional the following filter programs 
	  to use all of apsfilter's filetype auto-recognition/print features:
		o pbmplus (Jeff Poskanzers bitmap utilities
		o dvips
		o xfig / transfig
		o jpeg
		o html2ps

(1)	login as root

(2)	extract the gnuzipped tar archive in a subdirectory
	of your choice, i.e.:

		# cd /usr/local/lib
		# gtar xvzf ~/incoming/apsfilter-x.y.z.tar.gz
		or:
		# gzip -d < apsfilter-x.y.z.tar.gz | tar xvf -

(3)	Install the filter using the SETUP shellscript

		# cd apsfilter
		# ./SETUP

	What SETUP does for you:
	- printer config questions
	- automatic /etc/printcap installation (saves original and old)
	- installation of spooldir's as needed
	- compiles and installs a2ps in apsfilters bin
	  directory /usr/local/lib/apsfilter/bin (or whereever you
	  deceided where apsfilter's base directory should reside).

(4)	optionally edit the system wide apsfilterrc file
	/etc/apsfilterrc to choose sane defaults. Some options
	are only for experts, so beware !

	An INSECURE Flag that can be set globally in /etc/apsfilterrc.
        Only by setting INSECURE to True, its possible, that users 
	custom configuration files ($HOME/.apsfilterrc) will be
	executed during runtime.

	So, if you want to use $HOME/.apsfilterrc, then your root
	has to set INSECURE in /etc/apsfilterrc first. After that
	you can copy /etc/apsfilterrc to $HOME/.apsfilterrc and
	change it for yur needs.

(5)	Print some files as final test ...

(6)	In case of trouble read the file TROUBLESHOOTING and FAQ
	If this doen't cure your problems and you need help,
	then report a bug using the informations in:
		HOWTO-BUGREPORTS

