Add deprecation notices to the documentation to reflect recent additions to

PEP 4.

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

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

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

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