sync with cpython bb212a1a

Author: github-actions[bot]

deprecations/index.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-09-08 15:25+0800\n"
+"POT-Creation-Date: 2025-10-06 00:15+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -43,9 +43,9 @@ msgstr "模板字串"
 #: ../../library/string.templatelib.rst:24
 msgid ""
 "Template strings are a mechanism for custom string processing. They have the "
-"full flexibility of Python's :ref:`f-strings`, but return "
-"a :class:`Template` instance that gives access to the static and "
-"interpolated (in curly braces) parts of a string *before* they are combined."
+"full flexibility of Python's :ref:`f-strings`, but return a :class:"
+"`Template` instance that gives access to the static and interpolated (in "
+"curly brackets) parts of a string *before* they are combined."
 msgstr ""
 
 #: ../../library/string.templatelib.rst:30
@@ -81,10 +81,10 @@ msgstr ""
 
 #: ../../library/string.templatelib.rst:49
 msgid ""
-"The most common way to create a :class:`!Template` instance is to use "
-"the :ref:`template string literal syntax <t-strings>`. This syntax is "
-"identical to that of :ref:`f-strings <f-strings>`, except that it uses a "
-"``t`` prefix in place of an ``f``:"
+"The most common way to create a :class:`!Template` instance is to use the :"
+"ref:`template string literal syntax <t-strings>`. This syntax is identical "
+"to that of :ref:`f-strings <f-strings>`, except that it uses a ``t`` prefix "
+"in place of an ``f``:"
 msgstr ""
 
 #: ../../library/string.templatelib.rst:59
@@ -145,12 +145,12 @@ msgstr ""
 #: ../../library/string.templatelib.rst:139
 msgid ""
 "The ``values`` tuple always has the same length as the ``interpolations`` "
-"tuple. It is always equivalent to ``tuple(i.value for i in "
-"template.interpolations)``."
+"tuple. It is always equivalent to ``tuple(i.value for i in template."
+"interpolations)``."
 msgstr ""
 
 #: ../../library/string.templatelib.rst:144
-#: ../../library/string.templatelib.rst:314
+#: ../../library/string.templatelib.rst:317
 msgid "Methods"
 msgstr "方法"
 
@@ -177,8 +177,8 @@ msgstr ""
 
 #: ../../library/string.templatelib.rst:182
 msgid ""
-"Iterate over the template, yielding each non-empty string "
-"and :class:`Interpolation` in the correct order:"
+"Iterate over the template, yielding each non-empty string and :class:"
+"`Interpolation` in the correct order:"
 msgstr ""
 
 #: ../../library/string.templatelib.rst:191
@@ -219,28 +219,32 @@ msgid "The evaluated value of the interpolation."
 msgstr ""
 
 #: ../../library/string.templatelib.rst:261
-#: ../../library/string.templatelib.rst:323
-msgid "The text of a valid Python expression, or an empty string."
+msgid ""
+"For interpolations created by t-string literals, :attr:`!expression` is the "
+"expression text found inside the curly brackets (``{`` & ``}``), including "
+"any whitespace, excluding the curly brackets themselves, and ending before "
+"the first ``!``, ``:``, or ``=`` if any is present. For manually created "
+"interpolations, :attr:`!expression` is the arbitrary string provided when "
+"constructing the interpolation instance."
 msgstr ""
 
-#: ../../library/string.templatelib.rst:263
+#: ../../library/string.templatelib.rst:268
 msgid ""
-"The :attr:`.expression` is the original text of the interpolation's Python "
-"expression, if the interpolation was created from a t-string literal. "
-"Developers creating interpolations manually should either set this to an "
-"empty string or choose a suitable valid Python expression."
+"We recommend using valid Python expressions or the empty string for the "
+"``expression`` field of manually created :class:`!Interpolation` instances, "
+"although this is not enforced at runtime."
 msgstr ""
 
-#: ../../library/string.templatelib.rst:275
+#: ../../library/string.templatelib.rst:278
 msgid "The conversion to apply to the value, or ``None``."
 msgstr ""
 
-#: ../../library/string.templatelib.rst:277
+#: ../../library/string.templatelib.rst:280
 msgid ""
 "The :attr:`!conversion` is the optional conversion to apply to the value:"
 msgstr ""
 
-#: ../../library/string.templatelib.rst:285
+#: ../../library/string.templatelib.rst:288
 msgid ""
 "Unlike f-strings, where conversions are applied automatically, the expected "
 "behavior with t-strings is that code that *processes* the :class:`!Template` "
@@ -249,17 +253,17 @@ msgid ""
 "conversion semantics."
 msgstr ""
 
-#: ../../library/string.templatelib.rst:295
+#: ../../library/string.templatelib.rst:298
 msgid "The format specification to apply to the value."
 msgstr ""
 
-#: ../../library/string.templatelib.rst:297
+#: ../../library/string.templatelib.rst:300
 msgid ""
 "The :attr:`!format_spec` is an optional, arbitrary string used as the format "
 "specification to present the value:"
 msgstr ""
 
-#: ../../library/string.templatelib.rst:305
+#: ../../library/string.templatelib.rst:308
 msgid ""
 "Unlike f-strings, where format specifications are applied automatically via "
 "the :func:`format` protocol, the expected behavior with t-strings is that "
@@ -269,57 +273,61 @@ msgid ""
 "not conform to the :func:`format` protocol."
 msgstr ""
 
-#: ../../library/string.templatelib.rst:320
+#: ../../library/string.templatelib.rst:323
 msgid "Create a new :class:`!Interpolation` object from component parts."
 msgstr ""
 
 #: ../../library/string.templatelib.rst:0
 msgid "Parameters"
 msgstr ""
 
-#: ../../library/string.templatelib.rst:322
+#: ../../library/string.templatelib.rst:325
 msgid "The evaluated, in-scope result of the interpolation."
 msgstr ""
 
-#: ../../library/string.templatelib.rst:325
+#: ../../library/string.templatelib.rst:326
+msgid "The text of a valid Python expression, or an empty string."
+msgstr ""
+
+#: ../../library/string.templatelib.rst:328
 msgid ""
 "The :ref:`conversion <formatstrings>` to be used, one of ``None``, ``'a'``, "
 "``'r'``, or ``'s'``."
 msgstr ""
 
-#: ../../library/string.templatelib.rst:327
+#: ../../library/string.templatelib.rst:330
 msgid ""
 "An optional, arbitrary string used as the :ref:`format specification "
 "<formatspec>` to present the value."
 msgstr ""
 
-#: ../../library/string.templatelib.rst:332
+#: ../../library/string.templatelib.rst:335
 msgid "Helper functions"
 msgstr ""
 
-#: ../../library/string.templatelib.rst:336
+#: ../../library/string.templatelib.rst:339
 msgid ""
 "Applies formatted string literal :ref:`conversion <formatstrings-"
 "conversion>` semantics to the given object *obj*. This is frequently useful "
 "for custom template string processing logic."
 msgstr ""
 
-#: ../../library/string.templatelib.rst:340
+#: ../../library/string.templatelib.rst:343
 msgid "Three conversion flags are currently supported:"
 msgstr ""
 
-#: ../../library/string.templatelib.rst:342
+#: ../../library/string.templatelib.rst:345
 msgid "``'s'`` which calls :func:`str` on the value (like ``!s``),"
 msgstr ""
 
-#: ../../library/string.templatelib.rst:343
+#: ../../library/string.templatelib.rst:346
 msgid "``'r'`` which calls :func:`repr` (like ``!r``), and"
 msgstr ""
 
-#: ../../library/string.templatelib.rst:344
+#: ../../library/string.templatelib.rst:347
 msgid "``'a'`` which calls :func:`ascii` (like ``!a``)."
 msgstr ""
 
-#: ../../library/string.templatelib.rst:346
+#: ../../library/string.templatelib.rst:349
 msgid "If the conversion flag is ``None``, *obj* is returned unchanged."
 msgstr ""