APSFILTER-BUG(1)

📦 version 7.2.6, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 APSFILTER-BUG(1) 💖

General Commands Manual vibes, bestie. This is the manual for apsfilter-bug, and ngl it's a little legend.

✨ NAME ✨

apsfilter-bug — makes you a half-automatic bug report for apsfilter 🐛📝

🦋 SYNOPSIS 🦋

apsfilter-bug

🎀 OPTIONS 🎀

  • none — literally zero. not one flag. it's giving "just run it and see" 💅

🌸 DESCRIPTION 🌸

okay so with the apsfilter-bug script you can automatically create a bug report for apsfilter(1). 🫶 It makes you a template report file, and then you edit it with your favourite editor — emacs(1) by default, or literally whatever you've put in the environment variable EDITOR. main character choice, honestly.

You're gonna see a couple of lines starting with #; those lines get removed before the report is sent. so if you actually want a # character at the start of a line, just indent it with a space. ✨ sneaky but correct.

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. no cap. 🔥

After you've 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. easy escape hatch, we love her 💜

🔥 NOTES 🔥

In addition to the stuff you've edited, some more information is appended to the bug report automatically. it does the homework for you:

  • 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

🌈 SEE ALSO 🌈

💀 BUGS 💀

See apsfilter software center — http://www.apsfilter.org/ — for new versions, bugfixes and known bugs. 👀

Please use the new tool apsfilter-bug(1) to release bug- or problem reports. It automatically presents you a 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 e-mail to the proper apsfilter mailinglist. 📬

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 aps2file(1) utility by typing:

aps2file -D -Z options file > /dev/null 2> file.debug

and including the debugging output in the file file.debug into the edit session of the apsfilter-bug utility, so that it is included into the mail to the apsfilter mailinglist. 🧚

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 /bin/sh or bash, then you should have no problems with redirection of stdout and stderr (> /dev/null 2> file.debug).

👑 DOCUMENTATION 👑

See official apsfilter homepage http://www.apsfilter.org/handbook.html — the Apsfilter Handbook including the Frequently Asked Questions (FAQ). 📚

🌟 USER FORUM 🌟

Please send questions to the official apsfilter help channel apsfilter-help@apsfilter.org. 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. 🫶

🕰️ HISTORY 🕰️

The apsfilter-bug manpage has been written by Michael Loßin <phallobst@web.de> and first appeared in apsfilter V 7.1.0. iconic origin story, fr fr ⭐

and that's the whole page bestie 💅 this one's a Debian situation, dated Dec 26, 2001 — go forth and file the good bug reports 🦋

📦 where this page comes from