]>
Commit | Line | Data |
---|---|---|
3185942a JA |
1 | .\" |
2 | .\" MAN PAGE COMMENTS to | |
3 | .\" | |
4 | .\" Chet Ramey | |
5 | .\" Case Western Reserve University | |
6 | .\" chet@po.cwru.edu | |
7 | .\" | |
a0c0a00f | 8 | .\" Last Change: Mon Feb 15 14:42:40 EST 2016 |
3185942a | 9 | .\" |
a0c0a00f | 10 | .TH BASHBUG 1 "2016 February 15" "GNU Bash-4.4" |
ccc6cda3 JA |
11 | .SH NAME |
12 | bashbug \- report a bug in bash | |
13 | .SH SYNOPSIS | |
3185942a | 14 | \fBbashbug\fP [\fI--version\fP] [\fI--help\fP] [\fIemail-address\fP] |
ccc6cda3 JA |
15 | .SH DESCRIPTION |
16 | .B bashbug | |
17 | is a shell script to help the user compose and mail bug reports | |
18 | concerning bash in a standard format. | |
19 | .B bashbug | |
20 | invokes the editor specified by the environment variable | |
21 | .SM | |
22 | .B EDITOR | |
23 | on a temporary copy of the bug report format outline. The user must | |
24 | fill in the appropriate fields and exit the editor. | |
25 | .B bashbug | |
b72432fd | 26 | then mails the completed report to \fIbug-bash@gnu.org\fP, or |
3185942a | 27 | \fIemail-address\fP. If the report cannot be mailed, it is saved in the |
ccc6cda3 JA |
28 | file \fIdead.bashbug\fP in the invoking user's home directory. |
29 | .PP | |
30 | The bug report format outline consists of several sections. The first | |
31 | section provides information about the machine, operating system, the | |
32 | bash version, and the compilation environment. The second section | |
33 | should be filled in with a description of the bug. The third section | |
34 | should be a description of how to reproduce the bug. The optional | |
35 | fourth section is for a proposed fix. Fixes are encouraged. | |
36 | .SH ENVIRONMENT | |
37 | .B bashbug | |
38 | will utilize the following environment variables if they exist: | |
39 | .TP | |
40 | .B EDITOR | |
41 | Specifies the preferred editor. If | |
42 | .SM | |
43 | .B EDITOR | |
44 | is not set, | |
45 | .B bashbug | |
a0c0a00f CR |
46 | attempts to locate a number of alternative editors, including |
47 | .BR emacs , | |
48 | and defaults to \fBvi\fP. | |
ccc6cda3 JA |
49 | .TP |
50 | .B HOME | |
51 | Directory in which the failed bug report is saved if the mail fails. | |
3185942a JA |
52 | .TP |
53 | .B TMPDIR | |
54 | Directory in which to create temporary files and directories. | |
55 | .SH "SEE ALSO" | |
56 | .TP | |
57 | \fIbash\fP(1) | |
58 | .SH AUTHORS | |
59 | Brian Fox, Free Software Foundation | |
60 | .br | |
61 | bfox@gnu.org | |
62 | .PP | |
63 | Chet Ramey, Case Western Reserve University | |
64 | .br | |
65 | chet@po.cwru.edu |