From aaec057d1ccf4eff2b519878820359c9f3021581 Mon Sep 17 00:00:00 2001 From: Savage Mechanic Date: Sat, 16 May 2026 19:24:41 +0100 Subject: [PATCH] gh-67512: Document IMAP4.append() flags argument (GH-149907) (cherry picked from commit 5f8d9d35753e22946880d4fefb123e8234706266) Co-authored-by: Savage Mechanic --- Doc/library/imaplib.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Doc/library/imaplib.rst b/Doc/library/imaplib.rst index 8732aa15d2f1be5..38a749b95f3e0e9 100644 --- a/Doc/library/imaplib.rst +++ b/Doc/library/imaplib.rst @@ -209,6 +209,11 @@ An :class:`IMAP4` instance has the following methods: Append *message* to named mailbox. + *flags* may be ``None`` or a string of IMAP flag tokens. Multiple + flags are separated by spaces, for example ``r'\Seen \Answered'``. + If *flags* is not already enclosed in parentheses, parentheses are + added automatically. + .. method:: IMAP4.authenticate(mechanism, authobject)