NAME

Mail::Box::Message::Dummy - a placeholder for a missing message in a list.

CLASS HIERARCHY

Mail::Box::Message::Dummy
is a Mail::Box::Message
is a Mail::Message + ::Construct
is a Mail::Reporter

SYNOPSIS

DESCRIPTION

Read Mail::Box-Overview first.

Dummy messages are used by modules which maintain ordered lists of messages, usually based on message-id. A good example is Mail::Box::Thread::Manager, which detects related messages by scanning the known message headers for references to other messages. As long as the referenced messages are not found inside the mailbox, their place is occupied by a dummy.

Be careful when using modules which may create dummies. Before trying to access the header or body use isDummy() to check if the message is a dummy message.

METHOD INDEX

The general methods for Mail::Box::Message::Dummy objects:

MMC bounce OPTIONS                    MM modified [BOOL]
MMC build [MESSAGE|BODY], CONTENT    MBM new OPTIONS
MMC buildFromBody BODY, HEADERS       MM nrLines
MBM copyTo FOLDER                     MM parent
 MM decoded OPTIONS                   MM parts
MBM delete                            MM print [FILEHANDLE]
MBM deleted [BOOL]                    MM printUndisclosed [FILEHANDLE]
 MM destinations                     MMC quotePrelude [STRING|FIELD]
 MM encode OPTIONS                   MMC reply OPTIONS
 MR errors                           MMC replySubject STRING
MBM folder [FOLDER]                   MR report [LEVEL]
 MM from|to|cc|bcc|date               MR reportAll [LEVEL]
 MM get FIELD                         MM send [MAILER], OPTIONS
 MM guessTimestamp                   MBM seqnr [INTEGER]
 MM isDummy                          MBM shortString
 MM isMultipart                       MM size
 MM isPart                            MM subject
 MM label LABEL [,VALUE]              MM timestamp
 MR log [LEVEL [,STRINGS]]            MM toplevel
 MM messageId                         MR trace [LEVEL]

The extra methods for extension writers:

 MR AUTOLOAD                          MM labels
 MM DESTROY                           MR logPriority LEVEL
 MM body [BODY]                       MR logSettings
 MM clone                             MR notImplemented
 MM coerce MESSAGE                    MM read PARSER, [BODYTYPE]
MBM diskDelete                       MBM readBody PARSER, HEAD [, BO...
 MM head [HEAD, [LABELS]]             MM readHead PARSER [,CLASS]
 MR inGlobalDestruction               MM storeBody BODY
 MM isDelayed                         MM takeMessageId [STRING]

Methods prefixed with an abbreviation are described in the following manual-pages:

 MM = L<Mail::Message>
 MR = L<Mail::Reporter>
MBM = L<Mail::Box::Message>
MMC = L<Mail::Message::Construct>

METHOD

new MESSAGE-ID

(Class method) Create a new dummy message to occupy the space for a real message with the specified MESSAGE-ID.

Examples:

my $message = Mail::Box::Message::Dummy->new($msgid);
if($message->isDummy) {...}

SEE ALSO

Mail::Box-Overview

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.003.

Copyright (c) 2001 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.