apsfilter-bug1

Usage

Options

none

Overview

With the apsfilter-bug script you can automatically create a bug report for apsfilter(1). A template report file is created which you can edit with your favourite editor ( emacs(1) by default, or whatever is entered in the environment variable EDITOR ).

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.

A very important piece of the bug report is the debugging log created by aps2file(1), probably with a command like

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.

After you have filled in as much (useful) information as possible, you must save the file under its original name, then exit your editor.

If you invoked apsfilter-bug by accident, or if you need some additional system information to include into the bug report, just exit your editor without saving the file.

Notes

In addition to the stuff you've edited, some more information is appended to the bug report automatically:

apsfilter version

7.2.6-stable

ghostscript version

(from 'gs --version')

system id

(from 'uname -a')

configure options

--prefix=/usr --sysconfdir=/etc --mandir=/usr/share/man --with-awk=/usr/bin/awk --with-sendmail=/usr/sbin/sendmail --with-shell=/bin/bash

shell executable

/bin/bash

awk executable

/usr/bin/awk

sendmail executable

/usr/sbin/sendmail

Files

/usr/bin/aps2file

script to create debugging output

Documentation

See official apsfilter homepage

http://www.apsfilter.org/handbook.html

Apsfilter Handbook including the Frequently Asked Questions (FAQ)

User forum

Please send questions to the official apsfilter help channel [email protected]. The above section BUGS and the file HOWTO-BUGREPORTS tells you how to report bugs. If you want to know how to troubleshoot your apsfilter installation, please read the manpage aps2file(1) and apsfilter-bug(1) as well as the Apsfilter Handbook carefully.