From: Patrick R <codeZeilen@users.noreply.github.com>
Date: Tue, 16 Dec 2025 11:21:38 +0000 (+0100)
Subject: gh-124864: Extends smtplib documentation on ESMTP options format (#132547)
X-Git-Tag: v3.15.0a3~14
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=58027999bf7491238a2e6393c93b73e5f265f160;p=thirdparty%2FPython%2Fcpython.git

gh-124864: Extends smtplib documentation on ESMTP options format (#132547)
---

diff --git a/Doc/library/smtplib.rst b/Doc/library/smtplib.rst
index 3ee8b82a1880..3bf5ec6099fa 100644
--- a/Doc/library/smtplib.rst
+++ b/Doc/library/smtplib.rst
@@ -458,9 +458,11 @@ An :class:`SMTP` instance has the following methods:
    Send mail.  The required arguments are an :rfc:`822` from-address string, a list
    of :rfc:`822` to-address strings (a bare string will be treated as a list with 1
    address), and a message string.  The caller may pass a list of ESMTP options
-   (such as ``8bitmime``) to be used in ``MAIL FROM`` commands as *mail_options*.
+   (such as ``"8bitmime"``) to be used in ``MAIL FROM`` commands as *mail_options*.
    ESMTP options (such as ``DSN`` commands) that should be used with all ``RCPT``
-   commands can be passed as *rcpt_options*.  (If you need to use different ESMTP
+   commands can be passed as *rcpt_options*. Each option should be passed as a string
+   containing the full text of the option, including any potential key
+   (for instance, ``"NOTIFY=SUCCESS,FAILURE"``). (If you need to use different ESMTP
    options to different recipients you have to use the low-level methods such as
    :meth:`!mail`, :meth:`!rcpt` and :meth:`!data` to send the message.)