grepmail - search mailboxes for a particular email

Grepmail searches a normal, gzip'd, bzip'd, or tzip'd mailbox for a given
regular expression, and returns those emails that match it. Piped input is
allowed, and date restrictions are supported.

New in version 4.1:
- Stripped auto-perl execution code, since it never works on all platforms.
  (Installation instructions modified to require the user to fix the #! line.)
- Minor changes to allow grepmail to run without -w complaints.

New in version 4.0:
- Fixed a bug where shell characters needed to be escaped for compressed
  files. (Bug found by Richard Clamp <richardc@tw2.com>
- Added #!/bin/sh as first line to make the rest compatible with csh/tcsh
  users. (Bug found by Ed Arnold <era@ucar.edu>)

See the file CHANGES for a complete change history.


INSTALLATION

Two versions of grepmail are included in this distribution:
- grepmail.DP uses Date::Parse, quick parsing engine.
- grepmail.DM uses Date::Manip, a more flexible date parsing module that has
  better error checking than Date::Parse, but which causes grepmail to run
  about 60% slower. Date::Manip understands leap years and support date
  specifications like "2nd Thursday in July".
- Just pick which one you like, and rename it to "grepmail"
- Edit the grepmail file so that the #! line uses the path to your perl. (Do
  "which perl" or "type perl" to find it.)


AUTHOR

Written by David Coppit (david@coppit.org, http://coppit.org/)

Please send any enhancements, questions, or suggestions you have.  Also send
me email if you would like to be notified of updates.  I have a suite of tests
that I can give you if you ask. Keep in mind that I'm likely to turn down
obscure features to avoid including everything but the kitchen sink.


LICENSE

This code is distributed under the GNU General Public License (GPL). See
http://www.opensource.org/gpl-license.html and http://www.opensource.org/.
