NAME
    Email::MIME::XMTP - Extends Email::MIME objects to read and write XMTP

SYNOPSIS
        use Email::MIME;
        use Email::MIME::XMTP;
        my $mail = Email::MIME->new($text);

        # Email::MIME::XMTP extra methods
        my $xmlstring = $mail->as_XML;

        my $mailer = Email::Simple->new;
        my $mail = $mailer->parseXML( xml => $xmlstring );

DESCRIPTION
    "Email::MIME::XMTP" extends Email::MIME to read and write XMTP.

    Read more about XMTP at http://www.openhealth.org/xmtp/

METHODS
    Methods are the same as the one of Email::MIME. With the addition of two
    extra ones for reading (parsing) and writing XMTP format. Plus one to
    set the elements/headers XML namespaces and prefixes.

  parseXML
    Parse an XML SOURCE containing an XMTP formatted message and return a
    mail object.

    The parseXML method takes any of the following parameters:

                   filename
                   xml
                   ioref

    One must be spacefied - it is an error if none is passed.

    This uses the familiar hash syntax, so an example might be:

            use Email::MIME::XMTP;
            my $mailer = new Email::MIME::XMTP;

            my $mail = $mailer->parseXML( filename => 'example-mail-xmtp.xml');

    The parameters represent a filename, a string containing XML and an open
    filehandle ref respectively.

  set_namespace( PREFIX, URI )
    Set the XML Namespace PREFIX to URI.

    Note a particular XML-Namespace can also be set and transported using
    the special MIME header X-XMTP-xmlns as follows:

     X-XMTP-xmlns-<prefix>: <uri>

    And then further referred into the MIME message using a X-XMTP-<prefix>
    header like:

     X-XMTP-<prefix>: value

    In a multipart message each part can have its scoped namespaces.

  as_XML( [@FILTER_HEADERS] )
    Returns an XML XMTP representation of a message. Optionally the
    FILTER_HEADERS array can be used to restrict the MIME headers to return.
    In case any special XML namespace is set, in addition to XMTP; the
    headers must be listed with their fully qualified XML QNAME e.g.
    myprefix:My-Header.

COPYRIGHT AND LICENSE
    Copyright (c) 2005 All rights reserved Asemantics S.r.l

    (see LICENSE file coming with this distribution)

AUTHOR
    Alberto Reggiori <alberto(at)asemantics.com>

Email::MIME COPYRIGHT AND LICENSE
    Copyright 2004 by Casey West

    Copyright 2003 by Simon Cozens

SEE ALSO
    XMTP http://www.openhealth.org/xmtp/

    Perl Email Project, http://pep.kwiki.org .

