From 551703ed03663258761bc79749edcd01ef0bbc99 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:46 +0200 Subject: [PATCH] [3.14] gh-79964: Clarify the imaplib fetch example in the docs (GH-152780) (GH-152860) 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 166455bae026..8022e415b639 100644 --- a/Doc/library/imaplib.rst +++ b/Doc/library/imaplib.rst @@ -723,3 +723,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