From: Fred Drake <fdrake@acm.org>
Date: Wed, 25 Sep 2002 22:13:27 +0000 (+0000)
Subject: Add deprecation notices to the documentation to reflect recent additions to
X-Git-Tag: v2.3c1~3978
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=4613876ee3136d07fc9c5a94acae2266468a4d2a;p=python

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 4397ac481e..1baff493cb 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 fbf24901be..a9cc09f90b 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 ae7c0bdc2e..d99567ab3b 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 9def8596bd..1f78721625 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},