Backport 1.23 documenting impending deprecation in favor to the email

package.

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