sync with cpython 462e2255

Author: github-actions[bot]

c-api/frame.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-12 00:15+0000\n"
+"POT-Creation-Date: 2025-11-11 00:15+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -56,95 +56,102 @@ msgid ""
 msgstr ""
 
 #: ../../c-api/frame.rst:34
+msgid ""
+"Create a new frame object. This function returns a :term:`strong reference` "
+"to the new frame object on success, and returns ``NULL`` with an exception "
+"set on failure."
+msgstr ""
+
+#: ../../c-api/frame.rst:40
 msgid "Return non-zero if *obj* is a frame object."
 msgstr ""
 
-#: ../../c-api/frame.rst:38
+#: ../../c-api/frame.rst:44
 msgid ""
 "Previously, this function was only available after including ``<frameobject."
 "h>``."
 msgstr ""
 
-#: ../../c-api/frame.rst:43
+#: ../../c-api/frame.rst:49
 msgid "Get the *frame* next outer frame."
 msgstr ""
 
-#: ../../c-api/frame.rst:45
+#: ../../c-api/frame.rst:51
 msgid ""
 "Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer frame."
 msgstr ""
 
-#: ../../c-api/frame.rst:53
+#: ../../c-api/frame.rst:59
 msgid "Get the *frame*'s :attr:`~frame.f_builtins` attribute."
 msgstr "取得 *frame* 的 :attr:`~frame.f_builtins` 屬性。"
 
-#: ../../c-api/frame.rst:55 ../../c-api/frame.rst:86
+#: ../../c-api/frame.rst:61 ../../c-api/frame.rst:92
 msgid "Return a :term:`strong reference`. The result cannot be ``NULL``."
 msgstr "回傳 :term:`strong reference`。結果不能為 ``NULL``。"
 
-#: ../../c-api/frame.rst:62
+#: ../../c-api/frame.rst:68
 msgid "Get the *frame* code."
 msgstr ""
 
-#: ../../c-api/frame.rst:64 ../../c-api/frame.rst:130
+#: ../../c-api/frame.rst:70 ../../c-api/frame.rst:136
 msgid "Return a :term:`strong reference`."
 msgstr "回傳 :term:`strong reference`。"
 
-#: ../../c-api/frame.rst:66
+#: ../../c-api/frame.rst:72
 msgid "The result (frame code) cannot be ``NULL``."
 msgstr ""
 
-#: ../../c-api/frame.rst:73
+#: ../../c-api/frame.rst:79
 msgid ""
 "Get the generator, coroutine, or async generator that owns this frame, or "
 "``NULL`` if this frame is not owned by a generator. Does not raise an "
 "exception, even if the return value is ``NULL``."
 msgstr ""
 
-#: ../../c-api/frame.rst:77
+#: ../../c-api/frame.rst:83
 msgid "Return a :term:`strong reference`, or ``NULL``."
 msgstr "回傳 :term:`strong reference` 或 ``NULL``。"
 
-#: ../../c-api/frame.rst:84
+#: ../../c-api/frame.rst:90
 msgid "Get the *frame*'s :attr:`~frame.f_globals` attribute."
 msgstr "取得 *frame* 的 :attr:`~frame.f_globals` 屬性。"
 
-#: ../../c-api/frame.rst:93
+#: ../../c-api/frame.rst:99
 msgid "Get the *frame*'s :attr:`~frame.f_lasti` attribute."
 msgstr "取得 *frame* 的 :attr:`~frame.f_lasti` 屬性。"
 
-#: ../../c-api/frame.rst:95
+#: ../../c-api/frame.rst:101
 msgid "Returns -1 if ``frame.f_lasti`` is ``None``."
 msgstr "如果 ``frame.f_lasti`` 是 ``None`` 則回傳 -1。"
 
-#: ../../c-api/frame.rst:102
+#: ../../c-api/frame.rst:108
 msgid "Get the variable *name* of *frame*."
 msgstr "取得 *frame* 的變數 *name*。"
 
-#: ../../c-api/frame.rst:104
+#: ../../c-api/frame.rst:110
 msgid "Return a :term:`strong reference` to the variable value on success."
 msgstr "在成功時回傳變數值的 :term:`strong reference`。"
 
-#: ../../c-api/frame.rst:105
+#: ../../c-api/frame.rst:111
 msgid ""
 "Raise :exc:`NameError` and return ``NULL`` if the variable does not exist."
 msgstr "如果變數不存在，則引發 :exc:`NameError` 並回傳 ``NULL``。"
 
-#: ../../c-api/frame.rst:106
+#: ../../c-api/frame.rst:112
 msgid "Raise an exception and return ``NULL`` on error."
 msgstr "在錯誤時引發例外並回傳 ``NULL``。"
 
-#: ../../c-api/frame.rst:108
+#: ../../c-api/frame.rst:114
 msgid "*name* type must be a :class:`str`."
 msgstr "*name* 的型別必須是 :class:`str`。"
 
-#: ../../c-api/frame.rst:115
+#: ../../c-api/frame.rst:121
 msgid ""
 "Similar to :c:func:`PyFrame_GetVar`, but the variable name is a C string "
 "encoded in UTF-8."
 msgstr ""
 
-#: ../../c-api/frame.rst:123
+#: ../../c-api/frame.rst:129
 msgid ""
 "Get the *frame*'s :attr:`~frame.f_locals` attribute. If the frame refers to "
 "an :term:`optimized scope`, this returns a write-through proxy object that "
@@ -153,21 +160,21 @@ msgid ""
 "directly (as described for :func:`locals`)."
 msgstr ""
 
-#: ../../c-api/frame.rst:134
+#: ../../c-api/frame.rst:140
 msgid ""
 "As part of :pep:`667`, return an instance of :c:var:"
 "`PyFrameLocalsProxy_Type`."
 msgstr ""
 
-#: ../../c-api/frame.rst:140
+#: ../../c-api/frame.rst:146
 msgid "Return the line number that *frame* is currently executing."
 msgstr ""
 
-#: ../../c-api/frame.rst:144
+#: ../../c-api/frame.rst:150
 msgid "Frame Locals Proxies"
 msgstr ""
 
-#: ../../c-api/frame.rst:148
+#: ../../c-api/frame.rst:154
 msgid ""
 "The :attr:`~frame.f_locals` attribute on a :ref:`frame object <frame-"
 "objects>` is an instance of a \"frame-locals proxy\". The proxy object "
@@ -176,39 +183,87 @@ msgid ""
 "to date with the live local variables in the frame itself."
 msgstr ""
 
-#: ../../c-api/frame.rst:154
+#: ../../c-api/frame.rst:160
 msgid "See :pep:`667` for more information."
 msgstr ""
 
-#: ../../c-api/frame.rst:158
+#: ../../c-api/frame.rst:164
 msgid "The type of frame :func:`locals` proxy objects."
 msgstr ""
 
-#: ../../c-api/frame.rst:162
+#: ../../c-api/frame.rst:168
 msgid "Return non-zero if *obj* is a frame :func:`locals` proxy."
 msgstr ""
 
-#: ../../c-api/frame.rst:165
+#: ../../c-api/frame.rst:172
+msgid "Legacy Local Variable APIs"
+msgstr ""
+
+#: ../../c-api/frame.rst:174
+msgid ""
+"These APIs are :term:`soft deprecated`. As of Python 3.13, they do nothing. "
+"They exist solely for backwards compatibility."
+msgstr ""
+
+#: ../../c-api/frame.rst:180 ../../c-api/frame.rst:194
+#: ../../c-api/frame.rst:207
+msgid "This function is :term:`soft deprecated` and does nothing."
+msgstr ""
+
+#: ../../c-api/frame.rst:182
+msgid ""
+"Prior to Python 3.13, this function would copy the :attr:`~frame.f_locals` "
+"attribute of *f* to the internal \"fast\" array of local variables, allowing "
+"changes in frame objects to be visible to the interpreter. If *clear* was "
+"true, this function would process variables that were unset in the locals "
+"dictionary."
+msgstr ""
+
+#: ../../c-api/frame.rst:188 ../../c-api/frame.rst:201
+#: ../../c-api/frame.rst:213
+msgid "This function now does nothing."
+msgstr ""
+
+#: ../../c-api/frame.rst:196
+msgid ""
+"Prior to Python 3.13, this function would copy the internal \"fast\" array "
+"of local variables (which is used by the interpreter) to the :attr:`~frame."
+"f_locals` attribute of *f*, allowing changes in local variables to be "
+"visible to frame objects."
+msgstr ""
+
+#: ../../c-api/frame.rst:209
+msgid ""
+"Prior to Python 3.13, this function was similar to :c:func:"
+"`PyFrame_FastToLocals`, but would return ``0`` on success, and ``-1`` with "
+"an exception set on failure."
+msgstr ""
+
+#: ../../c-api/frame.rst:218
+msgid ":pep:`667`"
+msgstr ""
+
+#: ../../c-api/frame.rst:222
 msgid "Internal Frames"
 msgstr ""
 
-#: ../../c-api/frame.rst:167
+#: ../../c-api/frame.rst:224
 msgid "Unless using :pep:`523`, you will not need this."
 msgstr ""
 
-#: ../../c-api/frame.rst:171
+#: ../../c-api/frame.rst:228
 msgid "The interpreter's internal frame representation."
 msgstr ""
 
-#: ../../c-api/frame.rst:177
+#: ../../c-api/frame.rst:234
 msgid "Return a :term:`strong reference` to the code object for the frame."
 msgstr ""
 
-#: ../../c-api/frame.rst:184
+#: ../../c-api/frame.rst:241
 msgid "Return the byte offset into the last executed instruction."
 msgstr ""
 
-#: ../../c-api/frame.rst:191
+#: ../../c-api/frame.rst:248
 msgid ""
 "Return the currently executing line number, or -1 if there is no line number."
 msgstr ""