There are now packages for PPM available as well! See below the bits on 
installation to learn how to install those.

--------------------------------------------------------------------------------

Mail::MboxParser is a module for working with UNIX-flavoured mailboxes.
This document describes version 0.51.

Its purpose is to _easily_ extract messages from a mailbox with _simple_ 
access to header fields, body and MIME-parts. It is for those people who 
find the above two module-sets too confusing and heavy-weighted. See the 
list of provided methods below.
It is particularly easy to deal with any kind of attached files. See the 
supplied store_att.pl script for an example. 

Prerequisites:
--------------

    + MIME::Tools (probably >= 5.0)
    + MIME::QuotedPrint (don't know which version)
    
    optional:
    + Mail::Mbox::MessageParser (highly recommended but not necessary)
    + URI::Find if you want to use Mail::MboxParser::Mail::Body->extract_urls
    + Encode (standard module for >= perl5.8.0)

Installation:
-------------

    'make'-enabled systems:
    -----------------------
    Un'tar xfz' the module and 'cd' into the new directory 
    Mail-MboxParser-$VERSION.

    Then install:
        perl Makefile.PL
        make
        make test
        make install

    Win-users having an 'nmake' installed can also do the above, given the
    fact they replace 'make' with 'nmake' in the above list.

    Win-systems:
    ------------
    There should be ppm distributions for ActivePerl under Windows. 
    
    For ActivePerl 5.6.x:

    ppm install 
        http://www-users.rwth-aachen.de/tassilo.parseval/ppm/mail-mboxparser/0.47/5.6/Mail-MboxParser.ppd

    For ActivePerl 5.8.x:

    ppm install 
        http://www-users.rwth-aachen.de/tassilo.parseval/ppm/mail-mboxparser/0.47/5.8/Mail-MboxParser.ppd
    
    If the appropriate package cannot be found, please bug the author.
    
Autoloader:
-----------
Read the Mail::MboxParser::Mail docs for invoking external methods.
The autoloading-mechanism will take care that the below and other things
will work:

	$mail->effective_type; # from MIME::Entity

Have a look into the eg-directory of the package for some (or one) example(s).

Contact:
--------
Bugs, feature requests, questions, comments etc. should be directly 
mailed to me.

Tassilo v. Parseval
<tassilo.von.parseval@rwth-aachen.de>

