From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sun, 5 Jul 2026 13:27:49 +0000 (+0200)
Subject: [3.14] gh-149930: Clarify imaplib response helper types (GH-149963) (GH-153124)
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=27075bf1d482e879e581fe23ff26641ab95627e6;p=thirdparty%2FPython%2Fcpython.git

[3.14] gh-149930: Clarify imaplib response helper types (GH-149963) (GH-153124)

(cherry picked from commit d2d415b9761a539c37ea4f950df4e9aab0eca6ed)

Co-authored-by: Savage Mechanic <savagemechanic@github.com>
Co-authored-by: savagemechanic <20458938+savagemechanic@users.noreply.github.com>
---

diff --git a/Doc/library/imaplib.rst b/Doc/library/imaplib.rst
index 514c22c69462..83c44f274c3c 100644
--- a/Doc/library/imaplib.rst
+++ b/Doc/library/imaplib.rst
@@ -135,11 +135,11 @@ The second subclass allows for connections created by a child process:
 The following utility functions are defined:
 
 
-.. function:: Internaldate2tuple(datestr)
+.. function:: Internaldate2tuple(resp)
 
-   Parse an IMAP4 ``INTERNALDATE`` string and return corresponding local
-   time.  The return value is a :class:`time.struct_time` tuple or
-   ``None`` if the string has wrong format.
+   Parse a :term:`bytes-like object` containing an IMAP4 ``INTERNALDATE``
+   response and return the corresponding local time.  The return value is a
+   :class:`time.struct_time` tuple or ``None`` if the input has wrong format.
 
 .. function:: Int2AP(num)
 
@@ -147,9 +147,11 @@ The following utility functions are defined:
    [``A`` .. ``P``].
 
 
-.. function:: ParseFlags(flagstr)
+.. function:: ParseFlags(resp)
 
-   Converts an IMAP4 ``FLAGS`` response to a tuple of individual flags.
+   Converts a :term:`bytes-like object` containing an IMAP4 ``FLAGS`` response
+   to a tuple of individual flags as :class:`bytes`.  The return value is an
+   empty tuple if the input has wrong format.
 
 
 .. function:: Time2Internaldate(date_time)