Message::Convert(3)

NAME
Mail::Message::Convert - conversions between message types

CLASS HIERARCHY
 Mail::Message::Convert
 is a Mail::Reporter

SYNOPSIS
Available methods are very converter-specific.

DESCRIPTION
This class is the base for various message (and message parts) converters. Some conversions are looselessly create new object, some are destroying or adding information. In most cases, converters are created by Mail::Box when they are needed.

The following converters are currently available:

* "Mail::Message::Convert::Html"
    Plays trics with HTML/XMHTML without help of external modules.

* "Mail::Message::Convert::HtmlFormatText"
    Converts HTML body objects to plain text objects using the HTML::FormatText module.

* "Mail::Message::Convert::HtmlFormatPS"
    Converts HTML body objects to Postscript objects using the HTML::FormatPS module.

* "Mail::Message::Convert::MailInternet"
    Converts the simple "Mail::Internet" messages into "Mail::Message" objects.

* "Mail::Message::Convert::MimeEntity"
    Converts the more complicated "MIME::Entity" messages into "Mail::Message" objects.

* "Mail::Message::Convert::TextAutoformat"
    Converts a text message into text using Text::Autoformat.

METHOD INDEX
Methods prefixed with an abbreviation are described in Mail::Reporter (MR).

The general methods for "Mail::Message::Convert" objects:

   MR errors                            MR reportAll [LEVEL]
   MR log [LEVEL [,STRINGS]]            MR trace [LEVEL]
      new OPTIONS                       MR warnings
   MR report [LEVEL]

The extra methods for extension writers:

   MR AUTOLOAD                          MR logSettings
   MR DESTROY                           MR notImplemented
   MR inGlobalDestruction                  selectedFields HEAD
   MR logPriority LEVEL

METHODS

new OPTIONS
     OPTIONS    DESCRIBED IN           DEFAULT
     log        Mail::Reporter         'WARNINGS'
     trace      Mail::Reporter         'WARNINGS'
     fields     Mail::Message::Convert <see description>

    * fields => NAMES|ARRAY-OF-NAMES|REGEXS
        Select the fields of a header which are to be handled. Other fields will not be used. By default, the "To", "From", "Cc", "Bcc", "Date", and "Subject" will be shown. Specify an empty list to get all fields. The value of this argument is passed to the "grepNames" of Mail::Message::Head.

METHODS for extension writers

selectedFields HEAD
    Returns a list of fields to be included in the format. The list is an ordered selection of the fields in the actual header, and filtered through the information as specified with the "fields" option for "new".

SEE ALSO
Mail::Box-Overview

For support and additional documentation, see http://perl.overmeer.net/mailbox/

AUTHOR
Mark Overmeer (mailbox@overmeer.net). All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

VERSION
This code is beta, version 2.018.

Copyright (c) 2001-2002 Mark Overmeer. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.