diff --git a/Doc/library/email.compat32-message.rst b/Doc/library/email.compat32-message.rst index 5754c2b65b239f..0c3234612cddfc 100644 --- a/Doc/library/email.compat32-message.rst +++ b/Doc/library/email.compat32-message.rst @@ -755,6 +755,8 @@ Here are the methods of the :class:`Message` class: .. 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. + The *defects* attribute contains a list of problems found when parsing + this message, excluding defects in message headers, as they are parsed + and detected only when accessed. See :mod:`email.errors` for a detailed + description of the possible parsing defects and :attr:`BaseHeader.defects + ` for defects in headers. diff --git a/Doc/library/email.message.rst b/Doc/library/email.message.rst index b70df130e06dfa..c5dd223d66e763 100644 --- a/Doc/library/email.message.rst +++ b/Doc/library/email.message.rst @@ -728,10 +728,11 @@ message objects. .. 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. - + The *defects* attribute contains a list of problems found when parsing + this message, excluding defects in message headers, as they are parsed + and detected only when accessed. See :mod:`email.errors` for a detailed + description of the possible parsing defects and :attr:`BaseHeader.defects + ` for defects in headers. .. class:: MIMEPart(policy=default)