Identifying a message
=====================

Wherever <MSGID> is used below any of the following is acceptable:

! -- The current message.
^ -- The message referenced by the In-Reply-To: header or, if that is
     not present, the first message referenced in the References: header.
  -- An explicit message id.

Identifying a bug
=================

Wherever <BUG> is used below any of the following is acceptable:

[0-9]*	-- An integer bug number.

-[0-9]* -- A back reference to a bug created by a previous command,
	e.g. via a preceeding "create <MSGID>". The first such bug is
	-1, the second is -2, etc. (Note: -1 is the first bug created in this
	mail, not the previous one, -2 is the second bug not the second last
	one).

it      -- The literal string "it" refers to the most recently referenced bug.
	NOTE that currently only bugs created by "create" become referencable
	in this way. This is itself a bug.

Identifying a person
====================

Wherever <ADDRESS> is used below any of the following is acceptable:

!    -- The email address listed in the From field of the mail.
o/w  -- An email address.

Comments
========

Lines beginning with a # and empty lines are considered comments.

Privileged Commands
===================

Certain commands are available only to maintainers. These are tagged
[MAINTONLY] below.

Available Commands
==================

affects <BUG> [+-]<VERSION> (, [+-]<VERSION>)?

	Marks <BUG> as affecting one or more given <VERSIONS> or removes the
	mark.

create <MSGID>

	[MAINTONLY] Create a new bug, rooted at <MSGID>. By default the title
	will be taken from the Subject line of <MSGID>

close <BUG>

	Close a bug

graft <BUG> <MSGID>

	Associate the new subthread rooted at <MSGID> with a <BUG>.

owner <BUG> <ADDRESS>

	[MAINTONLY] Set the owner of <BUG> to <ADDRESS>

prune <BUG> <MSGID>

	Remove the subthread rooted at <MSGID> from a <BUG>

thanks
goodbye
stop
quit
	Stop processing.

reopen <BUG>

	[MAINTONLY] Reopen a closed bug

severity <BUG> <SEVERITY>

	[MAINTONLY] Set the severity of a bug. <SEVERITY> must be a valid
	severity level as defined in the config.

title <BUG> [New title]

	[MAINTONLY] Set the title of the bug. The default is to use the subject
	of the original mail