Add deprecation notices to the documentation to reflect recent additions to
PEP 4.
diff --git a/Doc/lib/libmimetools.tex b/Doc/lib/libmimetools.tex
index 4397ac4..1baff49 100644
--- a/Doc/lib/libmimetools.tex
+++ b/Doc/lib/libmimetools.tex
@@ -4,6 +4,10 @@
\declaremodule{standard}{mimetools}
\modulesynopsis{Tools for parsing MIME-style message bodies.}
+\deprecated{2.3}{The \refmodule{email} package should be used in
+ preference to the \module{mimetools} module. This
+ module is present only to maintain backward
+ compatibility.}
This module defines a subclass of the
\refmodule{rfc822}\refstmodindex{rfc822} module's
diff --git a/Doc/lib/libmimewriter.tex b/Doc/lib/libmimewriter.tex
index fbf2490..a9cc09f 100644
--- a/Doc/lib/libmimewriter.tex
+++ b/Doc/lib/libmimewriter.tex
@@ -6,6 +6,11 @@
\modulesynopsis{Generic MIME file writer.}
\sectionauthor{Christopher G. Petrilli}{petrilli@amber.org}
+\deprecated{2.3}{The \refmodule{email} package should be used in
+ preference to the \module{MimeWriter} module. This
+ module is present only to maintain backward
+ compatibility.}
+
This module defines the class \class{MimeWriter}. The
\class{MimeWriter} class implements a basic formatter for creating
MIME multi-part files. It doesn't seek around the output file nor
diff --git a/Doc/lib/libmimify.tex b/Doc/lib/libmimify.tex
index ae7c0bd..d99567a 100644
--- a/Doc/lib/libmimify.tex
+++ b/Doc/lib/libmimify.tex
@@ -4,8 +4,12 @@
\declaremodule{standard}{mimify}
\modulesynopsis{Mimification and unmimification of mail messages.}
+\deprecated{2.3}{The \refmodule{email} package should be used in
+ preference to the \module{mimify} module. This
+ module is present only to maintain backward
+ compatibility.}
-The mimify module defines two functions to convert mail messages to
+The \module{mimify} module defines two functions to convert mail messages to
and from MIME format. The mail message can be either a simple message
or a so-called multipart message. Each part is treated separately.
Mimifying (a part of) a message entails encoding the message as
diff --git a/Doc/lib/librfc822.tex b/Doc/lib/librfc822.tex
index 9def859..1f78721 100644
--- a/Doc/lib/librfc822.tex
+++ b/Doc/lib/librfc822.tex
@@ -4,6 +4,11 @@
\declaremodule{standard}{rfc822}
\modulesynopsis{Parse \rfc{2822} style mail messages.}
+\deprecated{2.3}{The \refmodule{email} package should be used in
+ preference to the \module{rfc822} module. This
+ module is present only to maintain backward
+ compatibility.}
+
This module defines a class, \class{Message}, which represents an
``email message'' as defined by the Internet standard
\rfc{2822}.\footnote{This module originally conformed to \rfc{822},