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 and size restrictions are supported.

New in version 4.48:
- Grepmail now converts Gnus emails into mbox emails before printing them.

New in version 4.47:
- Fixed a couple bugs in -M processing
- -M is now 19% faster. (It's now only about 9% slower than without -M.)


MODULE DEPENDENCIES

grepmail, by itself, can search mailboxes based on regular expression
patterns. However, if you want to search based on date, the
Date::Parse module is required. If you want to use more complex date
specifications, then Date::Manip should be installed as well.

Starting with version 4.44, an additional module is distributed with
grepmail, called Mail::Folder::FastReader. It implements the email
reading capability in C for 10-20% faster execution, depending on your
system. This module is compiled and installed during the installation
of grepmail. (See below)

The Date::Parse module is part of the TimeDate distribution, which can be
downloaded from:

  http://www.perl.com/CPAN/authors/id/GBARR/

Date::Manip is at:

  http://www.perl.com/CPAN/authors/id/SBECK/

Alternatively, installation can be done automatically using the CPAN module:

  perl -MCPAN -e 'install Date::Parse'
  perl -MCPAN -e 'install Date::Manip'


INSTALLATION

=> On Non-Windows systems:

  % perl Makefile.PL
  [Choose whether or not to use Mail::Folder::FastReader.]
  % make
  % make test
  % make install

If make test fails, please run

  make testfunc

and see which test(s) are failing. Please email the output of running
the particular test with the -D flag (e.g.:

  blib/script/grepmail library -D -d "before July 9 1998" t/mailarc-1.txt

to the address below.

=> On Windows systems:

- Just copy "grepmail" to a place in your path


DOCUMENTATION

"perldoc grepmail"


HOMEPAGE

Visit http://grepmail.sourceforge.net/ for the latest version, mailing lists,
discussion forums, CVS access, and more.


PRIMARY AUTHOR

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


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/.