merge with 3.2

diff --cc Doc/library/email.parser.rst
index e70b429b4212d0b5435267942308285ec8304e3a,384c5c9ee03247c6dc69eccf9e4d7bff628bea42..a0303a4b6ec2ce3239fe28ee56791217a07549ce
--- 1/Doc/library/email.parser.rst
--- 2/Doc/library/email.parser.rst
+++ b/Doc/library/email.parser.rst
@@@ -150,12 -144,10 +152,10 @@@ have the same API as the :class:`Parser
        equivalent to wrapping *text* in a :class:`~io.StringIO` instance first and
        calling :meth:`parse`.
  
-       Optional *headersonly* is a flag specifying whether to stop parsing after
-       reading the headers or not.  The default is ``False``, meaning it parses
-       the entire contents of the file.
+       Optional *headersonly* is as with the :meth:`parse` method.
  
  
 -.. class:: BytesParser(_class=email.message.Message, strict=None)
 +.. class:: BytesParser(_class=email.message.Message, *, policy=policy.default)
  
     This class is exactly parallel to :class:`Parser`, but handles bytes input.
     The *_class* and *strict* arguments are interpreted in the same way as for