sync with cpython 6ffeef10

github-actions[bot] · web-flow · commit 0cd09b2501ae · 2025-07-24T00:18:17.000Z
diff --git a/howto/free-threading-extensions.po b/howto/free-threading-extensions.po
@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-06-27 07:36+0000\n"
+"POT-Creation-Date: 2025-07-24 00:16+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-"
@@ -268,68 +268,74 @@ msgid ":c:func:`PyList_GetItem`"
 msgstr ":c:func:`PyList_GetItem`"
 
 #: ../../howto/free-threading-extensions.rst:160
+#: ../../howto/free-threading-extensions.rst:162
 msgid ":c:func:`PyList_GetItemRef`"
 msgstr ":c:func:`PyList_GetItemRef`"
 
 #: ../../howto/free-threading-extensions.rst:162
+#, fuzzy
+msgid ":c:func:`PyList_GET_ITEM`"
+msgstr ":c:func:`PyList_GetItem`"
+
+#: ../../howto/free-threading-extensions.rst:164
 msgid ":c:func:`PyDict_GetItem`"
 msgstr ":c:func:`PyDict_GetItem`"
 
-#: ../../howto/free-threading-extensions.rst:162
 #: ../../howto/free-threading-extensions.rst:164
+#: ../../howto/free-threading-extensions.rst:166
 msgid ":c:func:`PyDict_GetItemRef`"
 msgstr ":c:func:`PyDict_GetItemRef`"
 
-#: ../../howto/free-threading-extensions.rst:164
+#: ../../howto/free-threading-extensions.rst:166
 msgid ":c:func:`PyDict_GetItemWithError`"
 msgstr ":c:func:`PyDict_GetItemWithError`"
 
-#: ../../howto/free-threading-extensions.rst:166
+#: ../../howto/free-threading-extensions.rst:168
 msgid ":c:func:`PyDict_GetItemString`"
 msgstr ":c:func:`PyDict_GetItemString`"
 
-#: ../../howto/free-threading-extensions.rst:166
+#: ../../howto/free-threading-extensions.rst:168
 msgid ":c:func:`PyDict_GetItemStringRef`"
 msgstr ":c:func:`PyDict_GetItemStringRef`"
 
-#: ../../howto/free-threading-extensions.rst:168
+#: ../../howto/free-threading-extensions.rst:170
 msgid ":c:func:`PyDict_SetDefault`"
 msgstr ":c:func:`PyDict_SetDefault`"
 
-#: ../../howto/free-threading-extensions.rst:168
+#: ../../howto/free-threading-extensions.rst:170
 msgid ":c:func:`PyDict_SetDefaultRef`"
 msgstr ":c:func:`PyDict_SetDefaultRef`"
 
-#: ../../howto/free-threading-extensions.rst:170
+#: ../../howto/free-threading-extensions.rst:172
 msgid ":c:func:`PyDict_Next`"
 msgstr ":c:func:`PyDict_Next`"
 
-#: ../../howto/free-threading-extensions.rst:170
+#: ../../howto/free-threading-extensions.rst:172
 msgid "none (see :ref:`PyDict_Next`)"
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:172
+#: ../../howto/free-threading-extensions.rst:174
 msgid ":c:func:`PyWeakref_GetObject`"
 msgstr ":c:func:`PyWeakref_GetObject`"
 
-#: ../../howto/free-threading-extensions.rst:172
 #: ../../howto/free-threading-extensions.rst:174
+#: ../../howto/free-threading-extensions.rst:176
 msgid ":c:func:`PyWeakref_GetRef`"
 msgstr ":c:func:`PyWeakref_GetRef`"
 
-#: ../../howto/free-threading-extensions.rst:174
+#: ../../howto/free-threading-extensions.rst:176
 msgid ":c:func:`PyWeakref_GET_OBJECT`"
 msgstr ":c:func:`PyWeakref_GET_OBJECT`"
 
-#: ../../howto/free-threading-extensions.rst:176
+#: ../../howto/free-threading-extensions.rst:178
 msgid ":c:func:`PyImport_AddModule`"
 msgstr ":c:func:`PyImport_AddModule`"
 
-#: ../../howto/free-threading-extensions.rst:176
+#: ../../howto/free-threading-extensions.rst:178
 msgid ":c:func:`PyImport_AddModuleRef`"
 msgstr ":c:func:`PyImport_AddModuleRef`"
 
-#: ../../howto/free-threading-extensions.rst:179
+#: ../../howto/free-threading-extensions.rst:181
 msgid ""
 "Not all APIs that return borrowed references are problematic.  For example, :"
 "c:func:`PyTuple_GetItem` is safe because tuples are immutable. Similarly, "
@@ -340,18 +346,18 @@ msgid ""
 "context is safe."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:187
+#: ../../howto/free-threading-extensions.rst:189
 msgid ""
 "Some of these functions were added in Python 3.13.  You can use the "
 "`pythoncapi-compat <https://github.com/python/pythoncapi-compat>`_ package "
 "to provide implementations of these functions for older Python versions."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:195
+#: ../../howto/free-threading-extensions.rst:197
 msgid "Memory Allocation APIs"
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:197
+#: ../../howto/free-threading-extensions.rst:199
 msgid ""
 "Python's memory management C API provides functions in three different :ref:"
 "`allocation domains <allocator-domains>`: \"raw\", \"mem\", and \"object\". "
@@ -361,36 +367,36 @@ msgid ""
 "where this was only a best practice and not a hard requirement."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:206
+#: ../../howto/free-threading-extensions.rst:208
 msgid ""
 "Search for uses of :c:func:`PyObject_Malloc` in your extension and check "
 "that the allocated memory is used for Python objects. Use :c:func:"
 "`PyMem_Malloc` to allocate buffers instead of :c:func:`PyObject_Malloc`."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:213
+#: ../../howto/free-threading-extensions.rst:215
 msgid "Thread State and GIL APIs"
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:215
+#: ../../howto/free-threading-extensions.rst:217
 msgid ""
 "Python provides a set of functions and macros to manage thread state and the "
 "GIL, such as:"
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:218
+#: ../../howto/free-threading-extensions.rst:220
 msgid ":c:func:`PyGILState_Ensure` and :c:func:`PyGILState_Release`"
 msgstr ":c:func:`PyGILState_Ensure` 和 :c:func:`PyGILState_Release`"
 
-#: ../../howto/free-threading-extensions.rst:219
+#: ../../howto/free-threading-extensions.rst:221
 msgid ":c:func:`PyEval_SaveThread` and :c:func:`PyEval_RestoreThread`"
 msgstr ":c:func:`PyEval_SaveThread` 和 :c:func:`PyEval_RestoreThread`"
 
-#: ../../howto/free-threading-extensions.rst:220
+#: ../../howto/free-threading-extensions.rst:222
 msgid ":c:macro:`Py_BEGIN_ALLOW_THREADS` and :c:macro:`Py_END_ALLOW_THREADS`"
 msgstr ":c:macro:`Py_BEGIN_ALLOW_THREADS` 和 :c:macro:`Py_END_ALLOW_THREADS`"
 
-#: ../../howto/free-threading-extensions.rst:222
+#: ../../howto/free-threading-extensions.rst:224
 msgid ""
 "These functions should still be used in the free-threaded build to manage "
 "thread state even when the :term:`GIL` is disabled.  For example, if you "
@@ -399,68 +405,68 @@ msgid ""
 "Python thread state."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:228
+#: ../../howto/free-threading-extensions.rst:230
 msgid ""
 "You should continue to call :c:func:`PyEval_SaveThread` or :c:macro:"
 "`Py_BEGIN_ALLOW_THREADS` around blocking operations, such as I/O or lock "
 "acquisitions, to allow other threads to run the :term:`cyclic garbage "
 "collector <garbage collection>`."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:235
+#: ../../howto/free-threading-extensions.rst:237
 msgid "Protecting Internal Extension State"
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:237
+#: ../../howto/free-threading-extensions.rst:239
 msgid ""
 "Your extension may have internal state that was previously protected by the "
 "GIL.  You may need to add locking to protect this state.  The approach will "
 "depend on your extension, but some common patterns include:"
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:241
+#: ../../howto/free-threading-extensions.rst:243
 msgid ""
 "**Caches**: global caches are a common source of shared state.  Consider "
 "using a lock to protect the cache or disabling it in the free-threaded build "
 "if the cache is not critical for performance."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:244
+#: ../../howto/free-threading-extensions.rst:246
 msgid ""
 "**Global State**: global state may need to be protected by a lock or moved "
 "to thread local storage. C11 and C++11 provide the ``thread_local`` or "
 "``_Thread_local`` for `thread-local storage <https://en.cppreference.com/w/c/"
 "language/storage_duration>`_."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:251
+#: ../../howto/free-threading-extensions.rst:253
 msgid "Building Extensions for the Free-Threaded Build"
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:253
+#: ../../howto/free-threading-extensions.rst:255
 msgid ""
 "C API extensions need to be built specifically for the free-threaded build. "
 "The wheels, shared libraries, and binaries are indicated by a ``t`` suffix."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:256
+#: ../../howto/free-threading-extensions.rst:258
 msgid ""
 "`pypa/manylinux <https://github.com/pypa/manylinux>`_ supports the free-"
 "threaded build, with the ``t`` suffix, such as ``python3.13t``."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:258
+#: ../../howto/free-threading-extensions.rst:260
 msgid ""
 "`pypa/cibuildwheel <https://github.com/pypa/cibuildwheel>`_ supports the "
 "free-threaded build if you set `CIBW_ENABLE to cpython-freethreading "
 "<https://cibuildwheel.pypa.io/en/stable/options/#enable>`_."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:263
+#: ../../howto/free-threading-extensions.rst:265
 msgid "Limited C API and Stable ABI"
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:265
+#: ../../howto/free-threading-extensions.rst:267
 msgid ""
 "The free-threaded build does not currently support the :ref:`Limited C API "
 "<limited-c-api>` or the stable ABI.  If you use `setuptools <https://"
@@ -470,24 +476,24 @@ msgid ""
 "API when building with the free-threaded build."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:273
+#: ../../howto/free-threading-extensions.rst:275
 msgid ""
 "You will need to build separate wheels specifically for the free-threaded "
 "build.  If you currently use the stable ABI, you can continue to build a "
 "single wheel for multiple non-free-threaded Python versions."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:279
+#: ../../howto/free-threading-extensions.rst:281
 msgid "Windows"
 msgstr "Windows"
 
-#: ../../howto/free-threading-extensions.rst:281
+#: ../../howto/free-threading-extensions.rst:283
 msgid ""
 "Due to a limitation of the official Windows installer, you will need to "
 "manually define ``Py_GIL_DISABLED=1`` when building extensions from source."
 msgstr ""
 
-#: ../../howto/free-threading-extensions.rst:286
+#: ../../howto/free-threading-extensions.rst:288
 msgid ""
 "`Porting Extension Modules to Support Free-Threading <https://py-free-"
 "threading.github.io/porting/>`_: A community-maintained porting guide for "
