NAME
    MIME::Lite - low-calorie MIME generator

    *WARNING: This is Alpha code. I have not yet fully tested it, and I
    can't guarantee that the interface won't change in the next few releases
    in a non-backwards-compatible manner. It is being provided to the
    community for suggestions and in the hopes that it will be useful.*

SYNOPSIS
        use MIME::Lite;


    Create a single-part message:

        # Create a new single-part message, to send a GIF file:
        $msg = new MIME::Lite 
                    From     =>'me@myhost.com',
                    To       =>'you@yourhost.com',
                    Cc       =>'some@other.com, some@more.com',
                    Subject  =>'Helloooooo, nurse!',
                    Type     =>'image/gif',
                    Encoding =>'base64',
                    Path     =>'hellonurse.gif';


    Create a multipart message (i.e., one with attachments):

        # Create a new multipart message:
        $msg = new MIME::Lite 
                    From    =>'me@myhost.com',
                    To      =>'you@yourhost.com',
                    Cc      =>'some@other.com, some@more.com',
                    Subject =>'A message with 2 parts...',
                    Type    =>'multipart/mixed';

        # Add parts (each "attach" has same arguments as "new"):
        attach $msg 
                    Type     =>'TEXT',   
                    Data     =>"Here's the GIF file you wanted";  
        attach $msg 
                    Type     =>'image/gif',
                    Path     =>'aaa000123.gif',
                    Filename =>'logo.gif';


    Output a message:

        # As a string...
        $str = $msg->as_string;

        # To a filehandle (say, a "sendmail" stream)...
        $msg->print(\*SENDMAIL);


DESCRIPTION
    In the never-ending quest for great taste with fewer calories, we
    proudly present: *MIME::Lite*.

    MIME::Lite is intended as a simple, standalone module for generating
    (not parsing!) MIME messages... specifically, it allows you to output a
    simple, decent single- or multi-part message with text or binary
    attachments. It does not require that you have the Mail:: or MIME::
    modules installed.

    You can specify each message part as either the literal data itself (in
    a scalar or array), or as a string which can be given to open() to get a
    readable filehandle (e.g., "<filename" or "somecommand|").

    You don't need to worry about encoding your message data: this module
    will do that for you. It handles the 5 standard MIME encodings.

    If you need more sophisticated behavior, please get the MIME-tools
    package instead. I will be more likely to add stuff to that toolkit over
    this one.

CHANGES
  Version 1.116

    Small bug in our private copy of encode_base64() was patched. *Thanks to
    Andreas Koenig for pointing this out.*

    New, prettier way of specifying mail message headers in `build()'.

    New quiet method to turn off warnings.

    Changed "stringify" methods to more-standard "as_string" methods.

AUTHOR
    Eryq, (who really should be wrapping holiday presents instead).
    eryq@enteract.com / http://enteract.com/~eryq.

    Created: 11 December 1996. Ho ho ho.

