NAME
   MIME-tools - modules for parsing (and creating!) MIME entities

SYNOPSIS
   For coding examples, see the MIME::Tools module. This manpage is for
   installers.

CONTENTS
 Modules in this toolkit

       Module       DSLI   Description                                  Info
       ----------   ----   ------------------------------------------   ----
       MIME::
       ::Body       adpO   Abstract message holder (file, scalar, etc.) ERYQ
       ::Decoder    bdpO   OO interface for decoding MIME messages      ERYQ
       ::Entity     bdpO   An extracted and decoded MIME entity         ERYQ
       ::Field::*   bdpO   Mail::Field subclasses for parsing fields    ERYQ
       ::Head       bdpO   A parsed MIME header (Mail::Header subclass) ERYQ
       ::Parser     bdpO   Parses streams to create MIME entities       ERYQ
       ::ParserBase bdpO   For building your own MIME parser            ERYQ
       ::ToolUtils  bdpO   Utilities for the MIME-tools kit             ERYQ
       ::Tools      bdpO   For configuring the MIME-tools library       ERYQ
       ::Words      bdpO   Decode encoded words in MIME headers         ERYQ

       ::IO         ****   DEPRECATED; now done via IO:: modules        ERYQ
       ::Latin1     ****   DEPRECATED; may be moved to Text::           ERYQ

 Programs in this toolkit

       mimeabuse   - try hard to break MIME parsing
       mimedump    - dump out summary of the contents of a parsed MIME message
       mimeencode  - encode a file
       mimeexplode - explode one or more MIME messages
       mimeprint   - parse a MIME stream, and print the parsed entity
       mimesend    - send files via MIME mail, from the command line
       mimetour    - tour the possible encodings

 Layout of the distribution

       ./lib/MIME/         the MIME-tools classes
       ./Makefile.PL       the input to MakeMaker
       ./COPYING           terms and conditions for copying/using the software
       ./README            this file
       ./docs/             HTMLized documentation
       ./etc/              convenient copies of other modules you may need
       ./examples          sample executables
       ./t/*.t             the "make test" scripts
       ./testin/           files you can use for testing (as in "make test")
       ./testout/          the output of "make test"

REQUIREMENTS
   You'll need Perl5.002 or better, but you *should* get 5.004 as soon as
   possible... sorry, but it's the first release I know of with a non-
   broken FileHandle->new_tmpfile method. It's extremely worth upgrading to
   if you're using MIME-tools.

   You'll also need to obtain and install the following kits from the CPAN:

   IO-stringy
       This provides us with filehandle-like interfaces to scalars, and the
       ability to "wrap" foreign filehandles.

   MIME-Base64 (2.04 or higher)
       This kit contains MIME::Base64 and MIME::QuotedPrint, which perform
       the low-level MIME decoding. Get these from Gisle Aas' author
       directory. They are also reported to be in the LWP distribution.

   MailTools (1.11 or higher)
       This is Graham Barr's revamped set of Mail:: modules. Many of them
       are now superclasses of the MIME:: modules, and perform the core
       functionality of manipulating headers and fields.

AUTHOR
   MIME-tools was created by:

       ___  _ _ _   _  ___ _
      / _ \| '_| | | |/ _ ' /    Eryq (President, Zero G Inc.)
     |  __/| | | |_| | |_| |     http://www.zeegee.com/
      \___||_|  \__, |\__, |__   [email protected]
                |___/    |___/

   For full credits, see the MIME::Tools module.