The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Mail-Box-3.002
River stage one • 8 direct dependents • 8 total dependents
16 ++
/ Mail::Server

NAME

Mail::Server - Base class for email servers in MailBox

INHERITANCE

 Mail::Server
   is a Mail::Reporter

 Mail::Server is extended by
   Mail::Server::IMAP4

SYNOPSIS

 my $server = Mail::Server::IMAP4->new($msg);
 my $server = Mail::Server::POP3->new($msg);

DESCRIPTION

This module is a place-holder, logical in the class hierarchy. On the moment, no full server has been implemented, but some parts of IMAP4 exist.

Servers:

Extends "DESCRIPTION" in Mail::Reporter.

METHODS

Extends "METHODS" in Mail::Reporter.

DETAILS

# This file contains parts which could be used for doc

* Labels

Labels are flags which come with a message. Usually: old, seen, replied, flagged, and trashed.

The folder-types differ how they store label information. Mbox folders use the Status and X-Status fields, MH folders keep a seperate labels file called .mh_sequences, and Maildir folders put the labels in the name of the file.

Keeping the labels right is quite complicated. The `[X-]Status' header lines are only immediately updated with Mbox messages which will cause them to be written. Those lines are ignored for MH and Maildir, however updated when a new version of such a message has to be written to file.

The reason behind the MH/Maildir way of storing labels is pure performance: labels are often needed. Opening each message to see how the labels are set is cheap for Mbox, which has to read the whole folder on opening anyway, but terribly expensive for directory origanized folders (as MH and Maildir) which need to take every single message from a separate file.

Often used labels: draft to be transmitted trashed to be deleted flagged selected current last used replied a reponse message was constructed seen handled by the user old existence of message seen by user in the previous opening of the folder.

DIAGNOSTICS

Error: Package $package does not implement $method.

Fatal error: the specific package (or one of its superclasses) does not implement this method where it should. This message means that some other related classes do implement this method however the class at hand does not. Probably you should investigate this and probably inform the author of the package.

SEE ALSO

This module is part of Mail-Box distribution version 3.002, built on March 31, 2017.

Do not forget to read Mail::Box-Overview, Mail::Box-Cookbook, and Mail::Box-Index. Examples are included in the Mail-Box distribution, directories 'examples' and 'scripts'.

Browseable manuals, papers, and other released material van be found at Website: http://perl.overmeer.net/mailbox/

The central modules (in separate distributions) in the MailBox suite are: Mail::Message, Mail::Box, Mail::Box::IMAP4, Mail::Box::POP3, Mail::Box::Parser::C, Mail::Box::Dbx (unpublished), Mail::Transport, Object::Realize::Later, and User::Identity.

Please post questions or ideas to the author markov@cpan.org.

LICENSE

Copyrights 2001-2017 by [Mark Overmeer]. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it under the Artistic license. See http://dev.perl.org/licenses/artistic.html