|
|
1.1 root 1: .TH BUGFILER 8 "18 July 1983"
2: .UC 4
3: .SH NAME
4: bugfiler \- file bug reports in folders automatically
5: .SH SYNOPSIS
6: .B bugfiler
7: [ mail directory ]
8: .SH DESCRIPTION
9: .I Bugfiler
10: is a program to automatically intercept bug reports, summarize them and
11: store them in the appropriate sub directories of the mail directory
12: specified on the command line or the (system dependent) default.
13: It is designed to be compatible with the Rand MH mail system.
14: .I Bugfiler
15: is normally invoked by the mail delivery program through
16: .IR aliases (5)
17: with a line such as the following in /usr/lib/aliases.
18: .PP
19: .DT
20: bugs:"|bugfiler /usr/bugs/mail"
21: .PP
22: It reads the message from the standard input or the named file, checks
23: the format and returns mail acknowledging receipt or a message
24: indicating the proper format. Valid reports are then summarized and
25: filed in the appropriate folder. Users can then log onto the system and
26: check the summary file for bugs that pertain to them.
27: Bug reports are submitted in RFC822 format and
28: must contain the following header lines:
29: .PP
30: .DT
31: Date: <date the report is received>
32: .br
33: From: <valid return address>
34: .br
35: Subject: <short summary of the problem>
36: .br
37: Index: <source directory>/<source file> <version> [Fix]
38: .PP
39: In addition, the body of the message must contain a line which
40: begins with ``Description:'' followed by zero or more lines describing the
41: problem in detail and a line beginning with ``Repeat-By:'' followed by zero or
42: more lines describing how to repeat the problem.
43: If the keyword `Fix' is specified in the `Index' line, then there must
44: also be a line beginning with ``Fix:'' followed by a diff of the old and new
45: source files or a description of what was done to fix the problem.
46: .PP
47: The `Index' line is the key to the filing mechanism. The source directory
48: name must match one of the folder names in the mail directory.
49: The message is then filed in this folder
50: and a line appended to the summary file in the following format:
51: .PP
52: .DT
53: <folder name>/<message number> <Index info>
54: .br
55: <Subject info>
56: .SH FILES
57: .ta 2.5i
58: /usr/new/lib/mh/deliver mail delivery program
59: .br
60: /usr/new/lib/mh/unixtomh converts unix mail format to mh format
61: .br
62: maildir/.ack the message sent in acknowledgement
63: .br
64: maildir/.format the message sent when format errors are detected
65: .br
66: maildir/summary the summary file
67: .br
68: maildir/Bf?????? temporary copy of the input message
69: .br
70: maildir/Rp?????? temporary file for the reply message.
71: .SH "SEE ALSO"
72: mh(1),
73: newaliases(1),
74: aliases(5)
75: .SH BUGS
76: .PP
77: Since mail can be forwarded in a number of different ways,
78: .I bugfiler
79: does not recognize forwarded mail and will reply/complain to the
80: forwarder instead of the original sender unless there is a `Reply-To'
81: field in the header.
82: .PP
83: Duplicate messages should be discarded or recognized and put somewhere
84: else.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.