[Python-checkins] Improve readability of `formataddr` docstring (GH-20963)
Miss Islington (bot)
webhook-mailer at python.org
Fri Jun 19 08:16:02 EDT 2020
https://github.com/python/cpython/commit/4dd10ed6942ab99bc5b0b1c5ecc88a753877aefd
commit: 4dd10ed6942ab99bc5b0b1c5ecc88a753877aefd
branch: 3.8
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2020-06-19T05:15:57-07:00
summary:
Improve readability of `formataddr` docstring (GH-20963)
For me as a non native English speaker, the sentence with its embedded clause was very hard to understand.
modified: Lib/email/utils.py
Automerge-Triggered-By: @csabella
(cherry picked from commit 66a65ba43cb3e68a43e32469c988dd7a6cff049c)
Co-authored-by: Jürgen Gmach <juergen.gmach at googlemail.com>
files:
M Lib/email/utils.py
diff --git a/Lib/email/utils.py b/Lib/email/utils.py
index 858f620e25bfb..07dd029cc0280 100644
--- a/Lib/email/utils.py
+++ b/Lib/email/utils.py
@@ -81,7 +81,7 @@ def formataddr(pair, charset='utf-8'):
If the first element of pair is false, then the second element is
returned unmodified.
- Optional charset if given is the character set that is used to encode
+ The optional charset is the character set that is used to encode
realname in case realname is not ASCII safe. Can be an instance of str or
a Charset-like object which has a header_encode method. Default is
'utf-8'.
More information about the Python-checkins
mailing list