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:

       •   Mail::Server::IMAP4

           Partial IMAP4 implementation.

       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 separate 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 response 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.004, built on December 22, 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 same terms as Perl
       itself.  See http://dev.perl.org/licenses/

perl v5.26.1                                       2018-01-04                                  Mail::Server(3pm)