NAME

       Mail::MboxParser::Mail::Convertable - convert mail for sending etc.

SYNOPSIS

           use Mail::MboxParser;

           [...]

           # $msg is a Mail::MboxParser::Mail-object
           my $mail = $msg->make_convertable;

           $mail->delete_from_header('date', 'message-id');
           $mail->replace_in_header('to', 'john.doe@foobar.com');
           $mail->add_to_header( ['cc', 'john.does.brother@foobar.com'],
                                 where => 'BEHIND' );
           $mail->send('sendmail');

DESCRIPTION

       This class adds means to convert an email object into something that could be send via
       SMTP, NNTP or dumped to a file or filehandle. Therefore, methods are provided that change
       the structure of an email which includes adding and removing of header-fields, MIME-parts
       etc and transforming them into objects of related modules.

       Currently, only basic manipulation of the header and sending using Mail::Mailer is
       provided. More is to come soon.

       This class works non-destructive. You first create a Convertable-object and do any
       modifications on this while the Mail-object from which it was derived will not be touched.

METHODS

       delete_from_header(header-fields)
           Given a list of header-field names, these fields will be removed from the header. If
           you want to re-send a message, you could for instance remove the cc-field cause
           otherwise the message would be carbon-copied to the addresses listed in the cc-field.

       add_to_header(array-ref)
       add_to_header(array-ref, where => 'BEFORE' | 'BEHIND')
           add_to_header() takes a reference to a two-element list whose first element specifies
           the header-field to add or to add to while the second elements specifies the data that
           should be added. 'where' specifies whether to add at the beginning or at the end of
           the header. Defaults to 'BEHIND' if not given.

       replace_in_header(header-field, new_data)
           First element must be the header-field to be replaced while the second argument must
           be a string indicating what will be the new content of the header-field.

       send(command, args)
           Literally inherited from Mail::Internet. Commands can be "mail" (using the UNIX-mail
           program), "sendmail" (using a configured sendmail or compatible MTA like exim), "smtp"
           (for using Net::SMTP) and "test" which will only display what would be sent using
           /bin/echo. Additional arguments will be passed on to Mail::Mailer->new() which is in
           fact what Mail::Internet->send() uses.

           For more details, see Mail::Mailer

VERSION

       This is version 0.55.

AUTHOR AND COPYRIGHT

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

       Copyright (c)  2001-2005 Tassilo von Parseval.  This program is free software; you can
       redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

       Mail::Internet, Mail::Mailer