0
0
mirror of https://github.com/python/cpython.git synced 2024-11-28 16:45:42 +01:00
cpython/Doc/lib/libmailbox.tex
Fred Drake 1947991c2f Remove all \bcode / \ecode cruft; this is no longer needed. See previous
checkin of myformat.sty.

Change "\renewcommand{\indexsubitem}{(...)}" to "\setindexsubitem{(...)}"
everywhere.

Some other minor nits that I happened to come across.
1998-02-13 06:58:54 +00:00

42 lines
1.4 KiB
TeX

\section{Standard Module \sectcode{mailbox}}
\label{module-mailbox}
\stmodindex{mailbox}
\setindexsubitem{(in module mailbox)}
This module defines a number of classes that allow easy and uniform
access to mail messages in a (unix) mailbox.
\begin{funcdesc}{UnixMailbox}{fp}
Access a classic \UNIX{}-style mailbox, where all messages are contained
in a single file and separated by ``From name time'' lines. \var{Fp}
is the file object pointing to the mailbox file.
\end{funcdesc}
\begin{funcdesc}{MmdfMailbox}{fp}
Access an MMDF-style mailbox, where all messages are contained
in a single file and separated by lines consisting of 4 control-A
characters. \var{Fp}
is the file object pointing to the mailbox file.
\end{funcdesc}
\begin{funcdesc}{MHMailbox}{dirname}
Access an MH mailbox, a directory with each message in a separate
file with a numeric name. \var{Dirname}
is the name of the mailbox directory.
\end{funcdesc}
\subsection{Mailbox Objects}
All implementations of Mailbox objects have one externally visible
method:
\begin{funcdesc}{next}{}
Return the next message in the mailbox, as a \code{rfc822.Message} object.
Depending on the mailbox implementation the \var{fp} attribute of this
object may be a true file object or a class instance simulating a file object,
taking care of things like message boundaries if multiple mail messages are
contained in a single file, etc.
\end{funcdesc}