From 58d92ac773a30cf4670e9931d67f04ef0d06d50e Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Thu, 2 Jul 2026 09:26:50 +0200 Subject: [PATCH] [3.15] gh-79964: Clarify the imaplib fetch example in the docs (GH-152780) (GH-152859) A FETCH response may contain additional or unsolicited data, so the message is not always data[0][1]. (cherry picked from commit 50ae0be74988564fb09746a49eb4b8f8e740f3c3) Co-authored-by: Serhiy Storchaka Co-authored-by: Claude Opus 4.8 (1M context) --- Doc/library/imaplib.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Doc/library/imaplib.rst b/Doc/library/imaplib.rst index b002f4978123..cf475734636a 100644 --- a/Doc/library/imaplib.rst +++ b/Doc/library/imaplib.rst @@ -725,3 +725,10 @@ retrieves and prints all messages:: M.close() M.logout() +.. note:: + + A ``FETCH`` response may contain additional or unsolicited data + (see :rfc:`3501`, section 7.4.2), + so production code should inspect the whole response + rather than rely on ``data[0][1]``. + -- 2.47.3