sync with cpython 206f1966

Author: github-actions[bot]

howto/free-threading-python.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-07 00:14+0000\n"
+"POT-Creation-Date: 2025-12-03 00:14+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-"
@@ -34,107 +34,105 @@ msgstr ""
 
 #: ../../howto/free-threading-python.rst:14
 msgid ""
-"The free-threaded mode is working and continues to be improved, but there is "
-"some additional overhead in single-threaded workloads compared to the "
-"regular build. Additionally, third-party packages, in particular ones with "
-"an :term:`extension module`, may not be ready for use in a free-threaded "
-"build, and will re-enable the :term:`GIL`."
+"Some third-party packages, in particular ones with an :term:`extension "
+"module`, may not be ready for use in a free-threaded build, and will re-"
+"enable the :term:`GIL`."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:20
+#: ../../howto/free-threading-python.rst:18
 msgid ""
 "This document describes the implications of free threading for Python code.  "
 "See :ref:`freethreading-extensions-howto` for information on how to write C "
 "extensions that support the free-threaded build."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:26
+#: ../../howto/free-threading-python.rst:24
 msgid ""
 ":pep:`703` – Making the Global Interpreter Lock Optional in CPython for an "
 "overall description of free-threaded Python."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:31
+#: ../../howto/free-threading-python.rst:29
 msgid "Installation"
 msgstr "安裝"
 
-#: ../../howto/free-threading-python.rst:33
+#: ../../howto/free-threading-python.rst:31
 msgid ""
 "Starting with Python 3.13, the official macOS and Windows installers "
 "optionally support installing free-threaded Python binaries.  The installers "
 "are available at https://www.python.org/downloads/."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:37
+#: ../../howto/free-threading-python.rst:35
 msgid ""
 "For information on other platforms, see the `Installing a Free-Threaded "
 "Python <https://py-free-threading.github.io/installing-cpython/>`_, a "
 "community-maintained installation guide for installing free-threaded Python."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:41
+#: ../../howto/free-threading-python.rst:39
 msgid ""
 "When building CPython from source, the :option:`--disable-gil` configure "
 "option should be used to build a free-threaded Python interpreter."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:46
+#: ../../howto/free-threading-python.rst:44
 msgid "Identifying free-threaded Python"
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:48
+#: ../../howto/free-threading-python.rst:46
 msgid ""
 "To check if the current interpreter supports free-threading, :option:`python "
 "-VV <-V>` and :data:`sys.version` contain \"free-threading build\". The new :"
 "func:`sys._is_gil_enabled` function can be used to check whether the GIL is "
 "actually disabled in the running process."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:53
+#: ../../howto/free-threading-python.rst:51
 msgid ""
 "The ``sysconfig.get_config_var(\"Py_GIL_DISABLED\")`` configuration variable "
 "can be used to determine whether the build supports free threading.  If the "
 "variable is set to ``1``, then the build supports free threading.  This is "
 "the recommended mechanism for decisions related to the build configuration."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:60
+#: ../../howto/free-threading-python.rst:58
 msgid "The global interpreter lock in free-threaded Python"
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:62
+#: ../../howto/free-threading-python.rst:60
 msgid ""
 "Free-threaded builds of CPython support optionally running with the GIL "
 "enabled at runtime using the environment variable :envvar:`PYTHON_GIL` or "
 "the command-line option :option:`-X gil`."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:66
+#: ../../howto/free-threading-python.rst:64
 msgid ""
 "The GIL may also automatically be enabled when importing a C-API extension "
 "module that is not explicitly marked as supporting free threading.  A "
 "warning will be printed in this case."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:70
+#: ../../howto/free-threading-python.rst:68
 msgid ""
 "In addition to individual package documentation, the following websites "
 "track the status of popular packages support for free threading:"
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:73
+#: ../../howto/free-threading-python.rst:71
 msgid "https://py-free-threading.github.io/tracking/"
 msgstr "https://py-free-threading.github.io/tracking/"
 
-#: ../../howto/free-threading-python.rst:74
+#: ../../howto/free-threading-python.rst:72
 msgid "https://hugovk.github.io/free-threaded-wheels/"
 msgstr "https://hugovk.github.io/free-threaded-wheels/"
 
-#: ../../howto/free-threading-python.rst:78
+#: ../../howto/free-threading-python.rst:76
 msgid "Thread safety"
 msgstr "執行緒安全"
 
-#: ../../howto/free-threading-python.rst:80
+#: ../../howto/free-threading-python.rst:78
 msgid ""
 "The free-threaded build of CPython aims to provide similar thread-safety "
 "behavior at the Python level to the default GIL-enabled build.  Built-in "
@@ -146,140 +144,98 @@ msgid ""
 "current or future behavior."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:91
+#: ../../howto/free-threading-python.rst:89
 msgid ""
 "It's recommended to use the :class:`threading.Lock` or other synchronization "
 "primitives instead of relying on the internal locks of built-in types, when "
 "possible."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:97
+#: ../../howto/free-threading-python.rst:95
 msgid "Known limitations"
 msgstr "已知限制"
 
-#: ../../howto/free-threading-python.rst:99
+#: ../../howto/free-threading-python.rst:97
 msgid ""
 "This section describes known limitations of the free-threaded CPython build."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:102
+#: ../../howto/free-threading-python.rst:100
 msgid "Immortalization"
 msgstr "不滅化 (Immortalization)"
 
-#: ../../howto/free-threading-python.rst:104
+#: ../../howto/free-threading-python.rst:102
 msgid ""
-"The free-threaded build of the 3.13 release makes some objects :term:"
-"`immortal`. Immortal objects are not deallocated and have reference counts "
-"that are never modified.  This is done to avoid reference count contention "
-"that would prevent efficient multi-threaded scaling."
+"In the free-threaded build, some objects are :term:`immortal`. Immortal "
+"objects are not deallocated and have reference counts that are never "
+"modified.  This is done to avoid reference count contention that would "
+"prevent efficient multi-threaded scaling."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:109
-msgid ""
-"An object will be made immortal when a new thread is started for the first "
-"time after the main thread is running.  The following objects are "
-"immortalized:"
+#: ../../howto/free-threading-python.rst:107
+msgid "As of the 3.14 release, immortalization is limited to:"
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:112
-msgid ""
-":ref:`function <user-defined-funcs>` objects declared at the module level"
-msgstr "在模組層級宣告的\\ :ref:`函式 <user-defined-funcs>`\\ 物件"
-
-#: ../../howto/free-threading-python.rst:113
-msgid ":ref:`method <instance-methods>` descriptors"
-msgstr ":ref:`方法 <instance-methods>`\\ 描述器"
-
-#: ../../howto/free-threading-python.rst:114
-msgid ":ref:`code <code-objects>` objects"
-msgstr ":ref:`程式碼 <code-objects>`\\ 物件"
-
-#: ../../howto/free-threading-python.rst:115
-msgid ":term:`module` objects and their dictionaries"
-msgstr ":term:`模組 <module>`\\ 物件及其字典"
-
-#: ../../howto/free-threading-python.rst:116
-msgid ":ref:`classes <classes>` (type objects)"
-msgstr ":ref:`類別 <classes>`\\ （型別物件）"
-
-#: ../../howto/free-threading-python.rst:118
+#: ../../howto/free-threading-python.rst:109
 msgid ""
-"Because immortal objects are never deallocated, applications that create "
-"many objects of these types may see increased memory usage under Python "
-"3.13.  This has been addressed in the 3.14 release, where the aforementioned "
-"objects use deferred reference counting to avoid reference count contention."
+"Code constants: numeric literals, string literals, and tuple literals "
+"composed of other constants."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:123
-msgid ""
-"Additionally, numeric and string literals in the code as well as strings "
-"returned by :func:`sys.intern` are also immortalized in the 3.13 release.  "
-"This behavior is part of the 3.14 release as well and it is expected to "
-"remain in future free-threaded builds."
+#: ../../howto/free-threading-python.rst:111
+msgid "Strings interned by :func:`sys.intern`."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:130
+#: ../../howto/free-threading-python.rst:115
 msgid "Frame objects"
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:132
+#: ../../howto/free-threading-python.rst:117
 msgid ""
-"It is not safe to access :ref:`frame <frame-objects>` objects from other "
-"threads and doing so may cause your program to crash .  This means that :"
-"func:`sys._current_frames` is generally not safe to use in a free-threaded "
-"build.  Functions like :func:`inspect.currentframe` and :func:`sys."
-"_getframe` are generally safe as long as the resulting frame object is not "
-"passed to another thread."
+"It is not safe to access :attr:`frame.f_locals` from a :ref:`frame <frame-"
+"objects>` object if that frame is currently executing in another thread, and "
+"doing so may crash the interpreter."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:140
+#: ../../howto/free-threading-python.rst:123
 msgid "Iterators"
 msgstr "疊代器"
 
-#: ../../howto/free-threading-python.rst:142
+#: ../../howto/free-threading-python.rst:125
 msgid ""
-"Sharing the same iterator object between multiple threads is generally not "
-"safe and threads may see duplicate or missing elements when iterating or "
-"crash the interpreter."
+"It is generally not thread-safe to access the same iterator object from "
+"multiple threads concurrently, and threads may see duplicate or missing "
+"elements."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:148
+#: ../../howto/free-threading-python.rst:131
 msgid "Single-threaded performance"
 msgstr "單執行緒效能"
 
-#: ../../howto/free-threading-python.rst:150
+#: ../../howto/free-threading-python.rst:133
 msgid ""
 "The free-threaded build has additional overhead when executing Python code "
-"compared to the default GIL-enabled build.  In 3.13, this overhead is about "
-"40% on the `pyperformance <https://pyperformance.readthedocs.io/>`_ suite. "
-"Programs that spend most of their time in C extensions or I/O will see less "
-"of an impact.  The largest impact is because the specializing adaptive "
-"interpreter (:pep:`659`) is disabled in the free-threaded build."
+"compared to the default GIL-enabled build.  The amount of overhead depends "
+"on the workload and hardware.  On the pyperformance benchmark suite, the "
+"average overhead ranges from about 1% on macOS aarch64 to 8% on x86-64 Linux "
+"systems."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:157
-msgid ""
-"The specializing adaptive interpreter has been re-enabled in a thread-safe "
-"way in the 3.14 release.  The performance penalty on single-threaded code in "
-"free-threaded mode is now roughly 5-10%, depending on the platform and C "
-"compiler used."
-msgstr ""
-
-#: ../../howto/free-threading-python.rst:164
+#: ../../howto/free-threading-python.rst:141
 msgid "Behavioral changes"
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:166
+#: ../../howto/free-threading-python.rst:143
 msgid ""
 "This section describes CPython behavioural changes with the free-threaded "
 "build."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:171
+#: ../../howto/free-threading-python.rst:148
 msgid "Context variables"
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:173
+#: ../../howto/free-threading-python.rst:150
 msgid ""
 "In the free-threaded build, the flag :data:`~sys.flags."
 "thread_inherit_context` is set to true by default which causes threads "
@@ -289,11 +245,11 @@ msgid ""
 "start with an empty :class:`~contextvars.Context()`."
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:183
+#: ../../howto/free-threading-python.rst:160
 msgid "Warning filters"
 msgstr ""
 
-#: ../../howto/free-threading-python.rst:185
+#: ../../howto/free-threading-python.rst:162
 msgid ""
 "In the free-threaded build, the flag :data:`~sys.flags."
 "context_aware_warnings` is set to true by default.  In the default GIL-"
@@ -303,3 +259,19 @@ msgid ""
 "catch_warnings` modifies the global filters list, which is not thread-safe.  "
 "See the :mod:`warnings` module for more details."
 msgstr ""
+
+#~ msgid ""
+#~ ":ref:`function <user-defined-funcs>` objects declared at the module level"
+#~ msgstr "在模組層級宣告的\\ :ref:`函式 <user-defined-funcs>`\\ 物件"
+
+#~ msgid ":ref:`method <instance-methods>` descriptors"
+#~ msgstr ":ref:`方法 <instance-methods>`\\ 描述器"
+
+#~ msgid ":ref:`code <code-objects>` objects"
+#~ msgstr ":ref:`程式碼 <code-objects>`\\ 物件"
+
+#~ msgid ":term:`module` objects and their dictionaries"
+#~ msgstr ":term:`模組 <module>`\\ 物件及其字典"
+
+#~ msgid ":ref:`classes <classes>` (type objects)"
+#~ msgstr ":ref:`類別 <classes>`\\ （型別物件）"