1999-02-19 17:11:39 +00:00
|
|
|
.TH BASHBUG 1 "1998 July 30" GNU
|
1996-12-23 17:02:34 +00:00
|
|
|
.SH NAME
|
|
|
|
|
bashbug \- report a bug in bash
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
\fBbashbug\fP [\fIaddress\fP]
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.B bashbug
|
|
|
|
|
is a shell script to help the user compose and mail bug reports
|
|
|
|
|
concerning bash in a standard format.
|
|
|
|
|
.B bashbug
|
|
|
|
|
invokes the editor specified by the environment variable
|
|
|
|
|
.SM
|
|
|
|
|
.B EDITOR
|
|
|
|
|
on a temporary copy of the bug report format outline. The user must
|
|
|
|
|
fill in the appropriate fields and exit the editor.
|
|
|
|
|
.B bashbug
|
1999-02-19 17:11:39 +00:00
|
|
|
then mails the completed report to \fIbug-bash@gnu.org\fP, or
|
1996-12-23 17:02:34 +00:00
|
|
|
\fIaddress\fP. If the report cannot be mailed, it is saved in the
|
|
|
|
|
file \fIdead.bashbug\fP in the invoking user's home directory.
|
|
|
|
|
.PP
|
|
|
|
|
The bug report format outline consists of several sections. The first
|
|
|
|
|
section provides information about the machine, operating system, the
|
|
|
|
|
bash version, and the compilation environment. The second section
|
|
|
|
|
should be filled in with a description of the bug. The third section
|
|
|
|
|
should be a description of how to reproduce the bug. The optional
|
|
|
|
|
fourth section is for a proposed fix. Fixes are encouraged.
|
|
|
|
|
.SH ENVIRONMENT
|
|
|
|
|
.B bashbug
|
|
|
|
|
will utilize the following environment variables if they exist:
|
|
|
|
|
.TP
|
|
|
|
|
.B EDITOR
|
|
|
|
|
Specifies the preferred editor. If
|
|
|
|
|
.SM
|
|
|
|
|
.B EDITOR
|
|
|
|
|
is not set,
|
|
|
|
|
.B bashbug
|
|
|
|
|
defaults to
|
|
|
|
|
.BR emacs .
|
|
|
|
|
.TP
|
|
|
|
|
.B HOME
|
|
|
|
|
Directory in which the failed bug report is saved if the mail fails.
|
