sync with cpython 5720f7fc

c-api/frame.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-07-17 17:39+0800\n"
+"POT-Creation-Date: 2023-12-06 00:03+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"
@@ -76,7 +76,7 @@ msgid ""
 msgstr ""
 
 #: ../../c-api/frame.rst:53
-msgid "Get the *frame*'s ``f_builtins`` attribute."
+msgid "Get the *frame*'s :attr:`~frame.f_builtins` attribute."
 msgstr ""
 
 #: ../../c-api/frame.rst:55 ../../c-api/frame.rst:86
@@ -107,11 +107,11 @@ msgid "Return a :term:`strong reference`, or ``NULL``."
 msgstr ""
 
 #: ../../c-api/frame.rst:84
-msgid "Get the *frame*'s ``f_globals`` attribute."
+msgid "Get the *frame*'s :attr:`~frame.f_globals` attribute."
 msgstr ""
 
 #: ../../c-api/frame.rst:93
-msgid "Get the *frame*'s ``f_lasti`` attribute."
+msgid "Get the *frame*'s :attr:`~frame.f_lasti` attribute."
 msgstr ""
 
 #: ../../c-api/frame.rst:95
@@ -146,7 +146,7 @@ msgid ""
 msgstr ""
 
 #: ../../c-api/frame.rst:123
-msgid "Get the *frame*'s ``f_locals`` attribute (:class:`dict`)."
+msgid "Get the *frame*'s :attr:`~frame.f_locals` attribute (:class:`dict`)."
 msgstr ""
 
 #: ../../c-api/frame.rst:132

c-api/init.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-08-01 00:03+0000\n"
+"POT-Creation-Date: 2023-12-06 00:03+0000\n"
 "PO-Revision-Date: 2023-04-24 20:49+0800\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -2197,43 +2197,43 @@ msgstr ""
 msgid ""
 "The value passed as the *what* parameter to a :c:type:`Py_tracefunc` "
 "function (but not a profiling function) when a line-number event is being "
-"reported. It may be disabled for a frame by setting :attr:`f_trace_lines` to "
-"*0* on that frame."
+"reported. It may be disabled for a frame by setting :attr:`~frame."
+"f_trace_lines` to *0* on that frame."
 msgstr ""
 
-#: ../../c-api/init.rst:1917
+#: ../../c-api/init.rst:1918
 msgid ""
 "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when "
 "a call is about to return."
 msgstr ""
 
-#: ../../c-api/init.rst:1923
+#: ../../c-api/init.rst:1924
 msgid ""
 "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when "
 "a C function is about to be called."
 msgstr ""
 
-#: ../../c-api/init.rst:1929
+#: ../../c-api/init.rst:1930
 msgid ""
 "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when "
 "a C function has raised an exception."
 msgstr ""
 
-#: ../../c-api/init.rst:1935
+#: ../../c-api/init.rst:1936
 msgid ""
 "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when "
 "a C function has returned."
 msgstr ""
 
-#: ../../c-api/init.rst:1941
+#: ../../c-api/init.rst:1942
 msgid ""
 "The value for the *what* parameter to :c:type:`Py_tracefunc` functions (but "
 "not profiling functions) when a new opcode is about to be executed.  This "
 "event is not emitted by default: it must be explicitly requested by setting :"
-"attr:`f_trace_opcodes` to *1* on the frame."
+"attr:`~frame.f_trace_opcodes` to *1* on the frame."
 msgstr ""
 
-#: ../../c-api/init.rst:1949
+#: ../../c-api/init.rst:1950
 msgid ""
 "Set the profiler function to *func*.  The *obj* parameter is passed to the "
 "function as its first parameter, and may be any Python object, or ``NULL``.  "
@@ -2243,29 +2243,29 @@ msgid ""
 "`PyTrace_LINE` :c:data:`PyTrace_OPCODE` and :c:data:`PyTrace_EXCEPTION`."
 msgstr ""
 
-#: ../../c-api/init.rst:1956
+#: ../../c-api/init.rst:1957
 msgid "See also the :func:`sys.setprofile` function."
 msgstr ""
 
-#: ../../c-api/init.rst:1958 ../../c-api/init.rst:1965
-#: ../../c-api/init.rst:1984 ../../c-api/init.rst:1991
+#: ../../c-api/init.rst:1959 ../../c-api/init.rst:1966
+#: ../../c-api/init.rst:1985 ../../c-api/init.rst:1992
 msgid "The caller must hold the :term:`GIL`."
 msgstr "呼叫者必須持有 :term:`GIL`。"
 
-#: ../../c-api/init.rst:1962
+#: ../../c-api/init.rst:1963
 msgid ""
 "Like :c:func:`PyEval_SetProfile` but sets the profile function in all "
 "running threads belonging to the current interpreter instead of the setting "
 "it only on the current thread."
 msgstr ""
 
-#: ../../c-api/init.rst:1967
+#: ../../c-api/init.rst:1968
 msgid ""
 "As :c:func:`PyEval_SetProfile`, this function ignores any exceptions raised "
 "while setting the profile functions in all threads."
 msgstr ""
 
-#: ../../c-api/init.rst:1975
+#: ../../c-api/init.rst:1976
 msgid ""
 "Set the tracing function to *func*.  This is similar to :c:func:"
 "`PyEval_SetProfile`, except the tracing function does receive line-number "
@@ -2276,65 +2276,65 @@ msgid ""
 "*what* parameter."
 msgstr ""
 
-#: ../../c-api/init.rst:1982
+#: ../../c-api/init.rst:1983
 msgid "See also the :func:`sys.settrace` function."
 msgstr "也請見 :func:`sys.settrace` 函式。"
 
-#: ../../c-api/init.rst:1988
+#: ../../c-api/init.rst:1989
 msgid ""
 "Like :c:func:`PyEval_SetTrace` but sets the tracing function in all running "
 "threads belonging to the current interpreter instead of the setting it only "
 "on the current thread."
 msgstr ""
 
-#: ../../c-api/init.rst:1993
+#: ../../c-api/init.rst:1994
 msgid ""
 "As :c:func:`PyEval_SetTrace`, this function ignores any exceptions raised "
 "while setting the trace functions in all threads."
 msgstr ""
 
-#: ../../c-api/init.rst:2002
+#: ../../c-api/init.rst:2003
 msgid "Advanced Debugger Support"
 msgstr ""
 
-#: ../../c-api/init.rst:2007
+#: ../../c-api/init.rst:2008
 msgid ""
 "These functions are only intended to be used by advanced debugging tools."
 msgstr ""
 
-#: ../../c-api/init.rst:2012
+#: ../../c-api/init.rst:2013
 msgid ""
 "Return the interpreter state object at the head of the list of all such "
 "objects."
 msgstr ""
 
-#: ../../c-api/init.rst:2017
+#: ../../c-api/init.rst:2018
 msgid "Return the main interpreter state object."
 msgstr ""
 
-#: ../../c-api/init.rst:2022
+#: ../../c-api/init.rst:2023
 msgid ""
 "Return the next interpreter state object after *interp* from the list of all "
 "such objects."
 msgstr ""
 
-#: ../../c-api/init.rst:2028
+#: ../../c-api/init.rst:2029
 msgid ""
 "Return the pointer to the first :c:type:`PyThreadState` object in the list "
 "of threads associated with the interpreter *interp*."
 msgstr ""
 
-#: ../../c-api/init.rst:2034
+#: ../../c-api/init.rst:2035
 msgid ""
 "Return the next thread state object after *tstate* from the list of all such "
 "objects belonging to the same :c:type:`PyInterpreterState` object."
 msgstr ""
 
-#: ../../c-api/init.rst:2041
+#: ../../c-api/init.rst:2042
 msgid "Thread Local Storage Support"
 msgstr ""
 
-#: ../../c-api/init.rst:2045
+#: ../../c-api/init.rst:2046
 msgid ""
 "The Python interpreter provides low-level support for thread-local storage "
 "(TLS) which wraps the underlying native TLS implementation to support the "
@@ -2344,109 +2344,109 @@ msgid ""
 "thread."
 msgstr ""
 
-#: ../../c-api/init.rst:2052
+#: ../../c-api/init.rst:2053
 msgid ""
 "The GIL does *not* need to be held when calling these functions; they supply "
 "their own locking."
 msgstr ""
 
-#: ../../c-api/init.rst:2055
+#: ../../c-api/init.rst:2056
 msgid ""
 "Note that :file:`Python.h` does not include the declaration of the TLS APIs, "
 "you need to include :file:`pythread.h` to use thread-local storage."
 msgstr ""
 
-#: ../../c-api/init.rst:2059
+#: ../../c-api/init.rst:2060
 msgid ""
 "None of these API functions handle memory management on behalf of the :c:"
 "expr:`void*` values.  You need to allocate and deallocate them yourself. If "
 "the :c:expr:`void*` values happen to be :c:expr:`PyObject*`, these functions "
 "don't do refcount operations on them either."
 msgstr ""
 
-#: ../../c-api/init.rst:2067
+#: ../../c-api/init.rst:2068
 msgid "Thread Specific Storage (TSS) API"
 msgstr ""
 
-#: ../../c-api/init.rst:2069
+#: ../../c-api/init.rst:2070
 msgid ""
 "TSS API is introduced to supersede the use of the existing TLS API within "
 "the CPython interpreter.  This API uses a new type :c:type:`Py_tss_t` "
 "instead of :c:expr:`int` to represent thread keys."
 msgstr ""
 
-#: ../../c-api/init.rst:2075
+#: ../../c-api/init.rst:2076
 msgid "\"A New C-API for Thread-Local Storage in CPython\" (:pep:`539`)"
 msgstr ""
 
-#: ../../c-api/init.rst:2080
+#: ../../c-api/init.rst:2081
 msgid ""
 "This data structure represents the state of a thread key, the definition of "
 "which may depend on the underlying TLS implementation, and it has an "
 "internal field representing the key's initialization state.  There are no "
 "public members in this structure."
 msgstr ""
 
-#: ../../c-api/init.rst:2085
+#: ../../c-api/init.rst:2086
 msgid ""
 "When :ref:`Py_LIMITED_API <stable>` is not defined, static allocation of "
 "this type by :c:macro:`Py_tss_NEEDS_INIT` is allowed."
 msgstr ""
 
-#: ../../c-api/init.rst:2091
+#: ../../c-api/init.rst:2092
 msgid ""
 "This macro expands to the initializer for :c:type:`Py_tss_t` variables. Note "
 "that this macro won't be defined with :ref:`Py_LIMITED_API <stable>`."
 msgstr ""
 
-#: ../../c-api/init.rst:2096
+#: ../../c-api/init.rst:2097
 msgid "Dynamic Allocation"
 msgstr ""
 
-#: ../../c-api/init.rst:2098
+#: ../../c-api/init.rst:2099
 msgid ""
 "Dynamic allocation of the :c:type:`Py_tss_t`, required in extension modules "
 "built with :ref:`Py_LIMITED_API <stable>`, where static allocation of this "
 "type is not possible due to its implementation being opaque at build time."
 msgstr ""
 
-#: ../../c-api/init.rst:2105
+#: ../../c-api/init.rst:2106
 msgid ""
 "Return a value which is the same state as a value initialized with :c:macro:"
 "`Py_tss_NEEDS_INIT`, or ``NULL`` in the case of dynamic allocation failure."
 msgstr ""
 
-#: ../../c-api/init.rst:2112
+#: ../../c-api/init.rst:2113
 msgid ""
 "Free the given *key* allocated by :c:func:`PyThread_tss_alloc`, after first "
 "calling :c:func:`PyThread_tss_delete` to ensure any associated thread locals "
 "have been unassigned. This is a no-op if the *key* argument is ``NULL``."
 msgstr ""
 
-#: ../../c-api/init.rst:2118
+#: ../../c-api/init.rst:2119
 msgid ""
 "A freed key becomes a dangling pointer. You should reset the key to ``NULL``."
 msgstr ""
 
-#: ../../c-api/init.rst:2123
+#: ../../c-api/init.rst:2124
 msgid "Methods"
 msgstr "方法"
 
-#: ../../c-api/init.rst:2125
+#: ../../c-api/init.rst:2126
 msgid ""
 "The parameter *key* of these functions must not be ``NULL``.  Moreover, the "
 "behaviors of :c:func:`PyThread_tss_set` and :c:func:`PyThread_tss_get` are "
 "undefined if the given :c:type:`Py_tss_t` has not been initialized by :c:"
 "func:`PyThread_tss_create`."
 msgstr ""
 
-#: ../../c-api/init.rst:2133
+#: ../../c-api/init.rst:2134
 msgid ""
 "Return a non-zero value if the given :c:type:`Py_tss_t` has been initialized "
 "by :c:func:`PyThread_tss_create`."
 msgstr ""
 
-#: ../../c-api/init.rst:2139
+#: ../../c-api/init.rst:2140
 msgid ""
 "Return a zero value on successful initialization of a TSS key.  The behavior "
 "is undefined if the value pointed to by the *key* argument is not "
@@ -2455,7 +2455,7 @@ msgid ""
 "no-op and immediately returns success."
 msgstr ""
 
-#: ../../c-api/init.rst:2148
+#: ../../c-api/init.rst:2149
 msgid ""
 "Destroy a TSS key to forget the values associated with the key across all "
 "threads, and change the key's initialization state to uninitialized.  A "
@@ -2464,31 +2464,31 @@ msgid ""
 "key -- calling it on an already destroyed key is a no-op."
 msgstr ""
 
-#: ../../c-api/init.rst:2157
+#: ../../c-api/init.rst:2158
 msgid ""
 "Return a zero value to indicate successfully associating a :c:expr:`void*` "
 "value with a TSS key in the current thread.  Each thread has a distinct "
 "mapping of the key to a :c:expr:`void*` value."
 msgstr ""
 
-#: ../../c-api/init.rst:2164
+#: ../../c-api/init.rst:2165
 msgid ""
 "Return the :c:expr:`void*` value associated with a TSS key in the current "
 "thread.  This returns ``NULL`` if no value is associated with the key in the "
 "current thread."
 msgstr ""
 
-#: ../../c-api/init.rst:2172
+#: ../../c-api/init.rst:2173
 msgid "Thread Local Storage (TLS) API"
 msgstr ""
 
-#: ../../c-api/init.rst:2174
+#: ../../c-api/init.rst:2175
 msgid ""
 "This API is superseded by :ref:`Thread Specific Storage (TSS) API <thread-"
 "specific-storage-api>`."
 msgstr ""
 
-#: ../../c-api/init.rst:2179
+#: ../../c-api/init.rst:2180
 msgid ""
 "This version of the API does not support platforms where the native TLS key "
 "is defined in a way that cannot be safely cast to ``int``.  On such "
@@ -2497,7 +2497,7 @@ msgid ""
 "platforms."
 msgstr ""
 
-#: ../../c-api/init.rst:2184
+#: ../../c-api/init.rst:2185
 msgid ""
 "Due to the compatibility problem noted above, this version of the API should "
 "not be used in new code."