.\" .\" $ApsCVS: src/apsfilter/man/apsfilter-bug.1.in,v 1.1.2.3 2002/02/24 20:47:52 andreas Exp $ .\" .Dd Dec 26, 2001 .Dt APSFILTER-BUG 1 .Os .Sh NAME .Nm apsfilter-bug .Nd create a half-automatic bug report for apsfilter .Sh SYNOPSIS .Nm apsfilter-bug .Sh OPTIONS none .Sh DESCRIPTION With the .Nm apsfilter-bug script you can automatically create a bug report for .Xr apsfilter 1 . A template report file is created which you can edit with your favourite editor ( .Xr emacs 1 by default, or whatever is entered in the environment variable .Ic EDITOR ). .Pp You will see a couple of lines starting with '#'; these lines will be removed before the report is sent. So if you want to use the '#' character at the beginning of a line, just indent it with a space. .Pp A very important piece of the bug report is the debugging log created by .Xr aps2file 1 , probably with a command like .Dl aps2file -D -o /dev/null [-P...] [-Z...] [input] 2> log.txt Unless you don't even have a chance to create a debugging log, it is crucial for serious bug hunting. .Pp After you have filled in as much (useful) information as possible, you must save the file under its original name, then exit your editor. .Pp If you invoked .Nm by accident, or if you need some additional system information to include into the bug report, just exit your editor without saving the file. .Sh NOTES In addition to the stuff you've edited, some more information is appended to the bug report automatically: .Pp .Bl -tag -width ghostscript_version -compact .It apsfilter version 7.2.6-stable .It ghostscript version (from 'gs --version') .It system id (from 'uname -a') .It configure options --prefix=/usr --sysconfdir=/etc --mandir=/usr/share/man --with-awk=/usr/bin/awk --with-sendmail=/usr/sbin/sendmail --with-shell=/bin/bash .It shell executable /bin/bash .It awk executable /usr/bin/awk .It sendmail executable /usr/sbin/sendmail .Sh FILES .Bl -tag -width /usr/bin/aps2file -compact .It Pa /usr/bin/aps2file script to create debugging output .Sh SEE ALSO .Xr apsfilter 1 , .Xr aps2file 1 .Sh BUGS See apsfilter software center - .Li http://www.apsfilter.org/ - for new versions, bugfixes and known bugs. .Pp Please use the new tool .Xr apsfilter-bug 1 to release bug- or problem reports. It automatically presents you a .Nm form in an editor window which asks you some standard questions. If you save and quit the editor session, then this report is sent automatically via .Nm e-mail to the proper apsfilter mailinglist. .Pp If apsfilter fails to print something or prints it in a way you wouldn't expect and you want to report an apsfilter error then please save the debugging output of one print session using the new .Xr aps2file 1 utility by typing .Nm aps2file -D -Z options file > /dev/null 2> file.debug and including the debugging output in the file .Nm file.debug into the edit session of the .Nm apsfilter-bug utility, so that it is included into the mail to the apsfilter mailinglist. .Pp Please note that you need to run /bin/sh (Bourne Shell), bash or a compatible shell, so that the above mentioned output redirection works. Under C-shell (/bin/csh) or tcsh it would't work. If you don't know, then simply make sure you use the Bournce shell by typing .Nm /bin/sh or .Nm bash , then you should have no problems with redirection of .Nm stdout and .Nm stderr (> /dev/null 2> file.debug). .Sh DOCUMENTATION See official apsfilter homepage .Bl -tag -width XXXXXXXXXXXXXTHIS_MUCH_SPACEXXXXXXXXXXX -compact .It Pa http://www.apsfilter.org/handbook.html Apsfilter Handbook including the Frequently Asked Questions (FAQ) .Sh USER FORUM Please send questions to the official apsfilter help channel .Ic apsfilter-help@apsfilter.org . The above section .Nm BUGS and the file .Ic HOWTO-BUGREPORTS tells you how to report bugs. If you want to know how to troubleshoot your apsfilter installation, please read the manpage .Xr aps2file 1 and .Xr apsfilter-bug 1 as well as the .Ic Apsfilter Handbook carefully. .Sh HISTORY The .Nm manpage has been written by Michael Loßin and first appeared in apsfilter V 7.1.0.