Add deprecation notices to the documentation to reflect recent additions to

PEP 4.

4 files changed, 19 insertions, 1 deletions

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},