this is the initial checkin of the bug_email.pl script into the bugzilla cvs tree under the contrib directory.  This is not my code, but I'm championing its maintanence right now, since I'm using and hacking on it heavily.  The list of contributors can be found in the file itself.

Changes I've made :
- updated to the newest CVS pull of bugzilla
- works out of contrib/bugzilla
- put in the MPL license header

Directions for use are in the file itself.  Essentially, you put in a procmailrc entry which cats the message to this script.

Changes coming in the near future ...

- canonical email transformation (i.e., seth@job.cs.brandeis.edu == seth@cs.brandeis.edu)
- default product and component (i.e., if you don't specify a product and component, it goes into a PENDING product)
- querying a bug over email
- appending a bug over email
- keywords over email
- use the globals.pl parameters functionality to edit and save this script's parameters
- integrate some setup in the checksetup.pl script

FWIW, the first two things are necessary for this to be useful in my setup, so they get an overwhelming bit of priority

Patch by Hugo Frappier <hfrappier@dreammechanics.com> -- make the
"check all" and "uncheck all" buttons work on IE.

Get rid of a bit of unused Javascript code.

Make the "mail a new password" text be a param.

The "put this named query in the footer" feature was choking if the
name of the query had a space in it.

Add an optional ability to stagger the headers in the bug list, which
is uglier, but often squeezes things better horizontally.

Simplify dependency wording.

Whoops, searches of "Comment changed (before|after)" were not working
correctly.

Nothing was checking that the bug number you entered for a duplicate
bug was actually a legal bug number.

REOPENing a bug now clears the resolution; most people will agree it
should have always had this behavior.

The "And" and "Or" buttons now work faster, if you have Javascript
enabled.  (If you don't have Javascript, they work just like they did
before.)

Allow searching of attachment stuff using boolean charts.

Patch by aclark@ghoti.org -- use localconfig file to get database
connection info.

Patch by aclark@ghoti.org -- clear the accumulation buffer before using it.

Don't regenerate the shadow database until we're sure that our DB is
up to snuff with what processmail expects.

Fixed busted mailto: link.

The "Show list" link that is supposed to quickly get you back to the
list of bugs you queried for was busted.

Apparently, you're supposed to put "#foo" stuff in a URL after all the
"?" and "&" stuff.  IE doesn't work if you don't.

Was crashing if you weren't already logged in.

Allow searching by "last change date" in the boolean charts.

Massive stomp on the query page and buglist page.  Added the ability
to use the "boolean charts" to do very powerful queries.

Patch by granrose@netscape.com -- put initial focus into bug# field.

Add support for keywords.

Patch by Rob Baham <robb@scitechsoft.com> -- links to other bugs
should be relative URLs, not absolute.

Allow searches for "all keywords" or "no keywords"; fixed some other
bugs around keyword queries.

Add a way to log all SQL requests made.

If adding the new "lastdiffed" field, it works out better to
initialize it to "now", not to "delta_ts".

Fixed minor grammatical typo.

Reworked preferences UI.  Added ability to turn off "My bugs" link at
bottom.  Made "My bugs" show bugs you own AND bugs you submitted.
Added ability to display your named queries in the footer.  Many
random bugfixes.

Added a way to query by bug numbers.  Added an "edit this query" link
when you view a buglist.

Very minor HTML tweaking.

New email code wasn't sending to people who had voted for a bug.
Added "My votes" link to footer.  Other minor voting-related fixes.

Fixed bug causing named queries to get all screwed up around "target
milestones".

Named queries (and the default query) are now stored server side, in
the database, rather than in cookies.  This means you have to log
in to use these features, but I have plans that require them to be
server-side.  (Besides, some people were beginning to run out of
cookie space.)

Add a way to remove a default query that you may have set.

Remove unused file

Added much more crosschecks, and simplified a lot of the code.

Fixed stupid typo that caused exact email searches in descriptions to crash.

Oops; previous change would cause delta_ts values to be lost in the bugs table.

The "login_name" field in the "profiles" table was not declared to be
unique.  Sure enough, somehow, I got 22 duplicated entries in my
database.  This code detects that, cleans up the duplicates, and then
tweaks the table to declare the field to be unique.  What a pain.

Can now search for people who have added text to a bug.

New email code wasn't notifying people of changes in state of
dependent bugs.

Honor the emailregexp param when checking email addresses.

Removed stupid test.

AACK!  checksetup.pl was stomping all over the new fielddefs table if
it got run more than once.  This checkin fixes that, and also changes
the DumpBugActivity() routine to give me enough information to
hopefully repair the damaged mozilla.org database...

Minor wording change to hopefully make it more obvious slight changes
in the "long description" search.

Stupid typo caused "any words" and "all words" searches on the long
description to crash.

Fixed stupid typo.

If no sort order is specified, use the cookie if available.

Remember the previous sort order in a cookie, and make that the
default sort order for new queries.  Add a new "show list" link to the
navigation header to return you to the list of selected bugs.

Patch by Christine Begle <cbegle@mozilla.org>>, with heavy
modifications by me -- let you query for "any words" and "all words",
as well as the existing substring and regexp stuff.

Patch by Klaas Freitag <freitag@suse.de>, with modifications by me --
don't generate HTML tables with more than 50 lines, as browsers generally
can't cope with huge tables.

Patch by Holger Schurig <holger@holger.om.org> -- add new localconfig
option to skip the database check (since that code doesn't work with
all versions of MySQL/Msql-mysql/Perl/moonphase).

Whoops; code to let people turn on new "newemailtech" pref was busted.

Added a new table fielddefs that records information about the
different fields we keep an activity log on.  The bugs_activity table
now has a pointer into that table instead of recording the name directly.

Set up a new, highly experimental email-notification scheme.  To turn
it on, the maintainer has to turn on the "New email tech" param, and
then individual users have to turn on the "New email tech" preference.

Invalid html, added trailing /html tag.

Continue making the last-changed date on a bug be updated if someone only adds a comment.

Don't try to put out the footer if we're shutdown (as that can try to access the DB which we don't want).

Moved all the long descriptions out of the bugs table, and into a new
table.  There is now a separate entry for each new long description,
rather than appending them all together in one big field.

Patch by Holger Schurig <holger@holger.om.org> -- don't display footer if they asked for no header.

Allow whitespace to be used to separate keywords.

Let's outlaw whitespace in keywords.

Added a way to disable a user.

Spruced up "editusers.cgi".  Added an "editusers" group.

Footer wasn't displaying new state after clicking "log out".

Stop ever using perl's crypt() function; only use mysql's.  (Using
both was causing corruption on about 1 in 40 passwords.)

Check for and rebuild busted password stuff.

Tell people that column changes are remembered using cookies.

Was sometimes checking extra checkboxes in the email area.

Very minor formatting tweak.

Added "Windows 2000" and "Mac System 9.0" to the OS list.

Add a space after the comma when listing a bug with multiple keywords,
to be consistant with the way it gets listed in bug lists.

Use new "keywords" cache to display keywords in bug lists.  Not only
is this much faster, but it also lets you sort by that column, and
requires less special-case code.

Added a "keywords" field to a bug, which is a cached string-based copy
of all the keywords assigned to the bug.  Right now, we only have code
that generates and maintains this field; soon will come code that
actually uses it.

Oops!  Fixed stupid typo in last patch.

If there is only one component, then select it for the user.

Patch by kevin@suberic.net (kevin lyda) -- reformated to 77 columns.

Checked in patch by Dawn Endico <endico@mozilla.org> -- when
reassigning by component, reassign the qa contact too.

Added "sanity check" to the list of things the maintainer gets to
choose from in the footer.

Added a missing PutFooter().

Patch by Ramon Felciano <felciano@ingenuity.com>, with many tweaks by
me.  Added a footer to every page.  Add some options to do things like
display checkboxes instead of scrolling lists, and a new formatting
for email diffs, and show list items capitalized instead of all upper
case.

Remove unused files.

Remove unused files.

Fixed typos.

Make wording a little more clear when a username is invalid.

Send one last email notification to people when a bug gets reassigned
away from them or they get removed from the CC list.

Allow displaying of a "keywords" column.

Was sometimes putting a silly timestamp in the change log.

Don't complain that the user isn't doing anything if he is actually
changing keywords.

Provide a simple param to let the maintainer shut down Bugzilla for a while.

"Change several bugs" was losing the sort order.

Fixed warnings.

Was making changes to bugs before validating the entries in the CC
field.  This caused mid-air collisions and other weirdnesses.

Worked around bug in older versions of MySQL that caused a report of
one bug matching a keyword when there really are zero.

Fixed a warning.

Asking for both keywords and CC info was creating corrupted SQL.

Stop generating the %::keywordsbyid hashtable that nothing was using.

Whoops; SQL doesn't seem to want me to mention a table in a SELECT statement
if I'm not going to use it.

Add support for a new "keywords" feature.  This lets some central
authority maintain a list of keywords, and users can associate any
keyword with any bug.

The new functionality won't appear until at least one keyword is
defined.

Note that you *must* run the "checksetup.pl" script after updating
this change, in order to create the new required tables "keywords" and
"keyworddefs".

Oops; fixed table alignment problem introduced by last change.