doc/muttbug.man

   1 .\" -*-nroff-*-
   2 .\"
   3 .\"
   4 .\"     Copyright (C) 1996-2000 Thomas Roessler <roessler@does-not-exist.org>
   5 .\"
   6 .\"     This program is free software; you can redistribute it and/or modify
   7 .\"     it under the terms of the GNU General Public License as published by
   8 .\"     the Free Software Foundation; either version 2 of the License, or
   9 .\"     (at your option) any later version.
  10 .\"
  11 .\"     This program is distributed in the hope that it will be useful,
  12 .\"     but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 .\"     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 .\"     GNU General Public License for more details.
  15 .\"
  16 .\"     You should have received a copy of the GNU General Public License
  17 .\"     along with this program; if not, write to the Free Software
  18 .\"     Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  19 .\"
  20 .TH flea 1 "July 2000" Unix "User Manuals"
  21 .SH NAME
  22 .PP
  23 flea \- Report a bug (or rather a flea) in mutt.
  24 .SH SYNOPSIS
  25 .PP
  26 .B flea
  27 .SH DESCRIPTION
  28 .PP
  29 .B flea
  30 is a shell script which helps you to submit a bug report against the
  31 .BR mutt (1)
  32 mail user agent.
  33 .PP
  34 If you invoke
  35 .BR flea ,
  36 you'll first be prompted for a short
  37 description of the problem you experience.  This will be used as the
  38 bug report's subject line, so it should be concise, but informative.
  39 .PP
  40 You are then asked to assign an initial severity level to the
  41 problem you observe;
  42 .B flea
  43 will give you a description which severity level is appropriate or
  44 not.
  45 .PP
  46 Then, you are asked for the location of a core dump (normally named
  47 .BR core )
  48 which may have been left over by a crash of your
  49 .BR mutt (1).
  50 You can just type \(lqno\(rq here, or you can enter the path leading
  51 to a core dump.
  52 .B flea
  53 will try to use either
  54 .BR sdb (1),
  55 .BR dbx (1),
  56 or
  57 .BR gdb (1)
  58 to extract some information from this core dump which may be helpful
  59 to developers in order to determine the reason for the crash.
  60 .PP
  61 Finally, you are asked whether or not you want to include personal
  62 and system
  63 .BR mutt (1)
  64 configuration files with the bug report.  If at all possible, we
  65 urge you to answer these questions with \(lqyes\(rq, since a
  66 reference configuration makes it incredibly easier to track down a
  67 problem.
  68 .PP
  69 If you are using Debian GNU/Linux,
  70 .B flea
  71 will now check whether or not
  72 .B mutt
  73 has been installed as a Debian
  74 package on your system, and suggest to file the bug against the
  75 .BR mutt (1)
  76 and Debian bug tracking systems.  This option was added since the
  77 .BR mutt (1)
  78 project uses another instantiation of the Debian bug tracking
  79 system, so submitting bugs against both systems in one pass is
  80 simple.
  81 .PP
  82 You are then dropped into your favorite editor as determined by the
  83 .B EDITOR
  84 and
  85 .B VISUAL
  86 environment variables.
  87 .PP
  88 Please give us details about the problem in the empty space below
  89 the line reading \(lqPlease type your report below this line\(rq.
  90 We are most interested in precise information on what symptoms you
  91 observe and what steps may be used to reproduce the bug.  Chances
  92 are that problems which can easily be reproduced will be fixed
  93 quickly.  So please take some time when filling out this part of the
  94 template.
  95 .PP
  96 The remainder of the template contains various kinds of information
  97 gathered from your system, including output of the
  98 .BR uname (1)
  99 command, output from
 100 .BR mutt (1)
 101 itself, and your system's
 102 .BR mutt (1)
 103 configuration files.  You may wish to browse through this part of
 104 the bug report form in order to avoid leaking confidential
 105 information to the public.
 106 .PP
 107 If you leave the editor,
 108 .B flea
 109 will give you the option to review, re-edit, submit, or abandon your
 110 bug report.  If you decide to submit it, a mail message containing
 111 your report will be sent to <submit@bugs.guug.de>.  You'll receive a
 112 copy of this message.
 113 .PP
 114 While your bug report is being processed by the bug tracking system,
 115 you will receive various e-mail messages from the bug tracking
 116 system informing you about what's going on: Once your bug report has
 117 been entered into the bug tracking system, it will be assigned a
 118 unique serial number about which you are informed via e-mail.  If
 119 you wish to submit additional information about the bug, you can
 120 just send it to the address
 121 .BR \fIserial\fP@bugs.guug.de .
 122 .PP
 123 Later, you will most likely receive questions from the developers
 124 about the problem you observed, and you will eventually be informed
 125 that your bug report has been closed.  This means that the bug has
 126 been fixed at least in the
 127 .BR cvs (1)
 128 repository.  If the answers you receive don't satisfy you, don't
 129 hesitate to contact the developers directly under
 130 .BR mutt-dev@mutt.org.
 131 .PP
 132 You can also browse your bug report and all additional information
 133 and replies connected to it using the bug tracking system's Web
 134 interface under the following URL:
 135 http://bugs.guug.de/
 136 .SH
 137 ENVIRONMENT
 138 .PP
 139 .B flea
 140 will use the following environment variables:
 141 .IP "EMAIL"
 142 Your electronic mail address.  Will be used to set the bug report's
 143 From header, and to send you a copy of the report.
 144 .IP "LOGNAME"
 145 Your login name.  If the
 146 .B EMAIL
 147 environment variable isn't set, this will be used instead to send
 148 you a copy of the report.  Setting the sender will be left to
 149 .BR sendmail (1)
 150 on your system.
 151 .IP "REPLYTO"
 152 If set, the bug report will contain a Reply-To header with the
 153 e-mail address contained in this environment variable.
 154 .IP "ORGANIZATION"
 155 If set, the bug report will contain an Organization header with the
 156 contents of this environment variable.
 157 .IP "PAGER"
 158 If set, this environment variable will be expected to contain the
 159 path to your favorite pager for viewing the bug report.  If unset,
 160 .BR more (1)
 161 will be used.
 162 .IP "VISUAL"
 163 If set, this environment variable will be expected to contain the
 164 path to your favorite visual editor.
 165 .IP "EDITOR"
 166 If set, this environment variable will be expected to contain the
 167 path to your favorite editor.  This variable is examined if and only
 168 if the
 169 .B VISUAL
 170 environment variable is unset.  If
 171 .B EDITOR
 172 is unset,
 173 .BR vi (1)
 174 will be used to edit the bug report.
 175 .SH
 176 FILES
 177 .PP
 178 .IP "core"
 179 If present, this file may contain a post-mortem memory dump of mutt.
 180 It will be inspected using the debugger installed on your system.
 181 .SH
 182 SEE ALSO
 183 .PP
 184 .BR dbx (1),
 185 .BR gdb (1),
 186 .BR lynx (1),
 187 .BR mutt (1),
 188 .BR muttrc (5),
 189 .BR sdb (1),
 190 .BR sendmail (1),
 191 .BR uname (1),
 192 .BR vi (1)
 193 .PP
 194 The mutt bug tracking system: http://bugs.guug.de/
 195 .SH
 196 AUTHOR
 197 .PP
 198 .B flea
 199 and this manual page were written by Thomas Roessler
 200 <roessler@does-not-exist.org>.