.be/bugs/e0858b12-0be3-49bb-ad7a-030e488bb2f1/comments/a0e846ed-1549-4ec3-b94d-391e54610f61/body

   1 On Sun, Jul 19, 2009 at 09:09:05AM +1000, Ben Finney wrote:
   2 > > The interface is basically "place your be command in the subject line"
   3 >
   4 > I would far prefer an interface of “place as many BE commands as you
   5 > like at the top of the message body, ending with an optional terminator
   6 > command, and they will each be executed in turn”.
   7 > ...
   8
   9 I think the idea behind my first approach was "you guys have
  10 experience with the command line BE interface, so it will be easier to
  11 test if you don't have to learn the DBT interface."  The Debian people
  12 have been doing this for a while though, so I imagine their email
  13 interface is pretty good ;).
  14
  15 Here's a short primer on my take on the DBT interface.
  16
  17 The DBT has three main email addresses, each with it's own parsing style.
  18   1) creating bugs (submit@bugs.debian.org)
  19   2) commenting on bugs (<bug-number>@bugs.debian.org)
  20   3) controlling/managing bugs (control@bugs.debian.org)
  21 I'm trying to squeeze these down into a single email address to avoid
  22 having to tinker with the mail delivery system, so I've got everything
  23 at (wking at tremily dot us) with subject tags:
  24   1) creating bugs
  25      Subject: [be-bug:submit] new bug summary ...
  26   2) commenting on bugs
  27      Subject: [be-bug:<bug-number>] human-specific subject
  28   3) control
  29      Subject: [be-bug] human-specific subject
  30
  31 The parsing styles each follow their DBT counterparts, but currently
  32 have a much restricted breadth.
  33
  34 The control-style consists of a list of allowed be commands, with one
  35 command per line.  Blank lines and lines beginning with '#' are
  36 ignored, as well anything following a line starting with '--'.  All the
  37 listed commands are executed in order and their output returned.
  38
  39 The comment-style interface appends a comment to the bug specified in
  40 the subject tag.  The the first non-multipart body is attached with
  41 the appropriate content-type.  In the case of "text/plain" contents,
  42 anything following a line starting with '--' is stripped.
  43
  44 The create-style interface creates a bug whose summary is given by the
  45 email's post-tag subject.  The body of the email must begin with a
  46 psuedo-header containing at least the "Version" field.  Anything after
  47 the pseudo-header and before a line starting with '--' is, if present,
  48 attached as the bugs first comment.
  49
  50 Take a look at my interfaces/email/interactive/examples for some
  51 examples.
  52
  53 --
  54 This email may be signed or encrypted with GPG (http://www.gnupg.org).
  55 The GPG signature (if present) will be attached as 'signature.asc'.
  56 For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy
  57
  58 My public key is at http://www.physics.drexel.edu/~wking/pubkey.txt