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.