https://github.com/python/cpython/commit/58027999bf7491238a2e6393c93b73e5f265f160
commit: 58027999bf7491238a2e6393c93b73e5f265f160
branch: main
author: Patrick R <[email protected]>
committer: hugovk <[email protected]>
date: 2025-12-16T13:21:38+02:00
summary:
gh-124864: Extends smtplib documentation on ESMTP options format (#132547)
files:
M Doc/library/smtplib.rst
diff --git a/Doc/library/smtplib.rst b/Doc/library/smtplib.rst
index 3ee8b82a1880f3..3bf5ec6099facb 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.)
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
