aboutsummaryrefslogtreecommitdiffstats
path: root/interfaces/email
diff options
context:
space:
mode:
authorW. Trevor King <wking@drexel.edu>2009-07-20 14:59:10 -0400
committerW. Trevor King <wking@drexel.edu>2009-07-20 14:59:10 -0400
commit84a9c8a8b93b45940d194ce898f7f3ca2adfe8e4 (patch)
tree02cad7545758f86db3bda96dfb57ef11143cf80d /interfaces/email
parenta408bd6c1d631ef4c1271b8d9574e4171ae85d2b (diff)
downloadbugseverywhere-84a9c8a8b93b45940d194ce898f7f3ca2adfe8e4.tar.gz
Added pseudo-header list to interfaces/email/interactive/README.
Also some minor textual cleanups.
Diffstat (limited to 'interfaces/email')
-rw-r--r--interfaces/email/interactive/README31
1 files changed, 17 insertions, 14 deletions
diff --git a/interfaces/email/interactive/README b/interfaces/email/interactive/README
index a1f21ef..87959e6 100644
--- a/interfaces/email/interactive/README
+++ b/interfaces/email/interactive/README
@@ -21,24 +21,24 @@ probably best to create a dedicated user. Incoming email is filtered
by procmail, with matching emails being piped into be-handle-mail for
execution.
-Once be-handle-mail recieves the email, the parsing method is selected
+Once be-handle-mail receives the email, the parsing method is selected
according to the subject tag that procmail used grab the email in the
first place. There are three parsing styles:
Style Subject
creating bugs [be-bug:submit] new bug summary
commenting on bugs [be-bug:<bug-id>] human-specific subject
control [be-bug] human-specific subject
-These are analagous to submit@bugs.debian.org, nnn@bugs.debian.org,
+These are analogous to submit@bugs.debian.org, nnn@bugs.debian.org,
and control@bugs.debian.org respectively.
Creating bugs
=============
-The create-style interface creates a bug whose summary is given by the
-email's post-tag subject. The body of the email must begin with a
-psuedo-header containing at least the "Version" field. Anything after
+This interface creates a bug whose summary is given by the email's
+post-tag subject. The body of the email must begin with a
+pseudo-header containing at least the "Version" field. Anything after
the pseudo-header and before a line starting with '--' is, if present,
-attached as the bugs first comment.
+attached as the bug's first comment.
From jdoe@example.com Fri Apr 18 12:00:00 2008
From: John Doe <jdoe@example.com>
@@ -57,12 +57,15 @@ attached as the bugs first comment.
--
Goofy tagline not included.
+Available pseudo-headers are Version, Reporter, Assign, Depend,
+Severity, Status, Tag, and Target.
+
Commenting on bugs
==================
-The comment-style interface appends a comment to the bug specified in
-the subject tag. The the first non-multipart body is attached with
-the appropriate content-type. In the case of "text/plain" contents,
+This interface appends a comment to the bug specified in the subject
+tag. The the first non-multipart body is attached with the
+appropriate content-type. In the case of "text/plain" contents,
anything following a line starting with '--' is stripped.
From jdoe@example.com Fri Apr 18 12:00:00 2008
@@ -81,7 +84,7 @@ anything following a line starting with '--' is stripped.
Controlling bugs
================
-The control-style consists of a list of allowed be commands, with one
+This interface consists of a list of allowed be commands, with one
command per line. Blank lines and lines beginning with '#' are
ignored, as well anything following a line starting with '--'. All the
listed commands are executed in order and their output returned.
@@ -122,15 +125,15 @@ procmail does will be logged to ~/be-mail/procmail.log.
If you're piggybacking the interface on top of an existing account,
you probably only need to add the be-handle-mail stanza to your
-existing ~/.procmailrc, since you will still want to recieve non-bug
+existing ~/.procmailrc, since you will still want to receive non-bug
emails.
Note that you will probably have to add a
- --be-dir /path/to/served/repo
-option to the be-handle-mail invocation so it knows what repo to
+ --be-dir /path/to/served/repository
+option to the be-handle-mail invocation so it knows what repository to
serve.
-Multiple repos may be served by the same email address by adding
+Multiple repositories may be served by the same email address by adding
multiple be-handle-mail stanzas, each matching a different tag, for
example the "[be-bug" portion of the stanza could be "[projectX-bug",
"[projectY-bug", etc. If you change the base tag, be sure to add a