# $ApsCVS: src/apsfilter/HOWTO-BUGREPORTS,v 1.16.2.4 2001/03/29 20:01:41 andreas Exp $

A P S F I L T E R   DEVELOPEMENT RELEASE

please mail this form to the following mailing list:

		apsfilter-current@apsfilter.org

with the subject:

		apsfilter 6.1.1: [short problem description]

(1) Some simple questions:

	Operating System  : FreeBSD 4.3
	if Linux	  : Linux Distribution, please Name and Version

	apsfilter Rel.    : apsfilter-6.1.1
	ghostscript Rel.  : gs 6.50 (make sure with gs -h)
	Printer           : Epson Stylus Pro
	serial/parallel   : parallel printer
	Mono/Color        : color printer
	Postscript-Printer: no
	Print Resolution  : gs driver default ?
	or                : GS_RESOL set by apsfilterrc file ?
	Your Full Name    : Foo Bar
	Your e-mail addr  : foo@bar.org

(2) - Problem description
    - what ghostscript printer driver did you use ?

(3) Any error messages from your operating system, indicating trouble 
    concerning TCP/IP, lpd ? Browse your systems syslog logfiles, i.e.
    /var/log/messages or /var/log/lpd-errs, ...

(4) Did you read all help-files ?

	The most important are:
		README, INSTALL, FAQ, TODO, ChangeLog, doc/README.TeX
	If not, then please do so first.

(5) Did you enable debugging in the apsfilter shellscript to track down
    simple errors yourself ? For more infos on how to do this, see the FAQ
    file. Please do so first !!!
    If you can't find the problem, then please send me the debugging
    output of *exactly* one print session.

(6) The printer entry from your /etc/printcap file, that caused trouble,
    i.e. if you have trouble forcing ASCII printing the entry from the
    printer named auto would be fine:

	lp|Printer1 auto:\
	    :lp=/dev/lp0:\
	    :if=/etc/apsfilter/basedir/bin/apsfilter:\
	    :sd=/var/spool/lpd/lp:\
	    :lf=/var/spool/lpd/lp/log:\
	    :af=/var/spool/lpd/lp/acct:\
	    :mx#0:\
	    :sh:

(7) Did you modify apsfilterrc in /etc/apsfilter and/or in the printer
    specific config directory /etc/apsfilter/NAME ?
    If you modified the file, try printing without the modifications.
    Still problems ?

(8) Does a private (user defineable) apsfilterrc exist ?
    Please Note: for security reasons only allowed if you defined
    USE_USER_CODE in the global or printer specific apsfilterrc file.
    Is there a  $HOME/.apsfilter/apsfilterrc.NAME  file, if yes does it
    include changes to any configuration variables ?

(9) Is it perhaps a file type recognition problem ?
    The output of your file(1) command on the file that can't be printed:
    i.e. type:	file file_that_can't_be_printed
		file_that_can't_be_printed: English text
    Please uncompress the file before (gunzip, bunzip2 etc).

(10) The part of your printers logfile that logged the commands of
     your failed print session, see lf= in /etc/printcap, i.e.:
	lp|Printer1 auto:\
	...
	    :lf=/var/spool/lpd/lp/log:\
	...
     So you find debugging output in the file
	/var/spool/lpd/lp/log
     This logfile contains debugging data, if you enabled debugging as
     described in the FAQ.
     For LPRng spoolers: depending on the configuration, debugging output
     might also be logged to the "status" file in the spool directory, e.g.
	/var/spool/lpd/lp/status

(11) Mostly true on Linux Distributions:
     Do you use the traditional printer spooler (lpd)
     or the one that is called LPRng (line printer next generation) ?

Thanks for complete informations !

	Andreas ///
