support define_macros / undef_macros in setup.cfg

Doc/library/email.message.rst

-:mod:`email.message`: Representing an email message
----------------------------------------------------
+:mod:`email`: Representing an email message
+-------------------------------------------
 
 .. module:: email.message
    :synopsis: The base class representing email messages.
 
 
 The central class in the :mod:`email` package is the :class:`Message` class,
 imported from the :mod:`email.message` module.  It is the base class for the
 :mod:`email` object model.  :class:`Message` provides the core functionality for
 setting and querying header fields, and for accessing message bodies.
 
@@ skipping 91 matching lines @@
       ``True``.  An :exc:`IndexError` will be raised if *i* is less than 0 or
       greater than or equal to the number of items in the payload.  If the
       payload is a string (i.e.  :meth:`is_multipart` is ``False``) and *i* is
       given, a :exc:`TypeError` is raised.
 
       Optional *decode* is a flag indicating whether the payload should be
       decoded or not, according to the :mailheader:`Content-Transfer-Encoding`
       header. When ``True`` and the message is not a multipart, the payload will
       be decoded if this header's value is ``quoted-printable`` or ``base64``.
       If some other encoding is used, or :mailheader:`Content-Transfer-Encoding`
-      header is missing, the payload is
+      header is missing, or if the payload has bogus base64 data, the payload is
       returned as-is (undecoded).  In all cases the returned value is binary
       data.  If the message is a multipart and the *decode* flag is ``True``,
-      then ``None`` is returned.  If the payload is base64 and it was not
-      perfectly formed (missing padding, characters outside the base64
-      alphabet), then an appropriate defect will be added to the message's
-      defect property (:class:`~email.errors.InvalidBase64PaddingDefect` or
-      :class:`~email.errors.InvalidBase64CharactersDefect`, respectively).
+      then ``None`` is returned.
 
       When *decode* is ``False`` (the default) the body is returned as a string
       without decoding the :mailheader:`Content-Transfer-Encoding`.  However,
       for a :mailheader:`Content-Transfer-Encoding` of 8bit, an attempt is made
       to decode the original bytes using the ``charset`` specified by the
       :mailheader:`Content-Type` header, using the ``replace`` error handler.
       If no ``charset`` is specified, or if the ``charset`` given is not
       recognized by the email package, the body is decoded using the default
       ASCII charset.
 
@@ skipping 427 matching lines @@
 
       You do not need to set the epilogue to the empty string in order for the
       :class:`Generator` to print a newline at the end of the file.
 
 
    .. attribute:: defects
 
       The *defects* attribute contains a list of all the problems found when
       parsing this message.  See :mod:`email.errors` for a detailed description
       of the possible parsing defects.