flea(1) User Manuals flea(1)
NAME
flea - Report a bug (or rather a flea) in mutt.
SYNOPSIS
flea
DESCRIPTION
flea is a shell script which helps you to submit a bug report against
the mutt(1) mail user agent.
If you invoke flea, you'll first be prompted for a short description
of the problem you experience. This will be used as the bug report's
subject line, so it should be concise, but informative.
You are then asked to assign an initial severity level to the problem
you observe; flea will give you a description which severity level is
appropriate or not.
Then, you are asked for the location of a core dump (normally named
core) which may have been left over by a crash of your mutt(1). You
can just type "no" here, or you can enter the path leading to a core
dump. flea will try to use either sdb(1), dbx(1), or gdb(1) to
extract some information from this core dump which may be helpful to
developers in order to determine the reason for the crash.
Finally, you are asked whether or not you want to include personal and
system mutt(1) configuration files with the bug report. If at all
possible, we urge you to answer these questions with "yes", since a
reference configuration makes it incredibly easier to track down a
problem.
If you are using Debian GNU/Linux, flea will now check whether or not
mutt has been installed as a Debian package on your system, and sug-
gest to file the bug against the mutt(1) and Debian bug tracking sys-
tems. This option was added since the mutt(1) project uses another
instantiation of the Debian bug tracking system, so submitting bugs
against both systems in one pass is simple.
You are then dropped into your favorite editor as determined by the
EDITOR and VISUAL environment variables.
Please give us details about the problem in the empty space below the
line reading "Please type your report below this line". We are most
interested in precise information on what symptoms you observe and
what steps may be used to reproduce the bug. Chances are that prob-
lems which can easily be reproduced will be fixed quickly. So please
take some time when filling out this part of the template.
The remainder of the template contains various kinds of information
gathered from your system, including output of the uname(1) command,
output from mutt(1) itself, and your system's mutt(1) configuration
files. You may wish to browse through this part of the bug report
form in order to avoid leaking confidential information to the public.
If you leave the editor, flea will give you the option to review, re-
edit, submit, or abandon your bug report. If you decide to submit it,
a mail message containing your report will be sent to . You'll receive a copy of this message.
While your bug report is being processed by the bug tracking system,
you will receive various e-mail messages from the bug tracking system
informing you about what's going on: Once your bug report has been
entered into the bug tracking system, it will be assigned a unique
serial number about which you are informed via e-mail. If you wish to
submit additional information about the bug, you can just send it to
the address serial@bugs.guug.de.
Later, you will most likely receive questions from the developers
about the problem you observed, and you will eventually be informed
that your bug report has been closed. This means that the bug has
been fixed at least in the cvs(1) repository. If the answers you
receive don't satisfy you, don't hesitate to contact the developers
directly under mutt-dev@mutt.org.
You can also browse your bug report and all additional information and
replies connected to it using the bug tracking system's Web interface
under the following URL: http://bugs.guug.de/
ENVIRONMENT
flea will use the following environment variables:
EMAIL Your electronic mail address. Will be used to set the bug
report's From header, and to send you a copy of the report.
LOGNAME
Your login name. If the EMAIL environment variable isn't set,
this will be used instead to send you a copy of the report.
Setting the sender will be left to sendmail(1) on your system.
REPLYTO
If set, the bug report will contain a Reply-To header with the
e-mail address contained in this environment variable.
ORGANIZATION
If set, the bug report will contain an Organization header with
the contents of this environment variable.
PAGER If set, this environment variable will be expected to contain
the path to your favorite pager for viewing the bug report. If
unset, more(1) will be used.
VISUAL If set, this environment variable will be expected to contain
the path to your favorite visual editor.
EDITOR If set, this environment variable will be expected to contain
the path to your favorite editor. This variable is examined if
and only if the VISUAL environment variable is unset. If EDI-
TOR is unset, vi(1) will be used to edit the bug report.
FILES
core If present, this file may contain a post-mortem memory dump of
mutt. It will be inspected using the debugger installed on
your system.
SEE ALSO
dbx(1), gdb(1), lynx(1), mutt(1), muttrc(5), sdb(1), sendmail(1),
uname(1), vi(1)
The mutt bug tracking system: http://bugs.guug.de/
AUTHOR
flea and this manual page were written by Thomas Roessler
.
Unix July 2000 flea(1)
UNIX/Linux commands referenced on this page:
- script
- which
- as
- dump
- crash
- at
- mutt
- file
- time
- login