sync with cpython b90161f6

Author: github-actions[bot]

c-api/stable.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-01-19 00:03+0000\n"
+"POT-Creation-Date: 2024-12-04 00:14+0000\n"
 "PO-Revision-Date: 2023-01-24 21:07+0800\n"
 "Last-Translator: Matt Wang <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -132,10 +132,11 @@ msgid "Limited C API"
 msgstr "受限 C API"
 
 #: ../../c-api/stable.rst:67
+#, fuzzy
 msgid ""
 "Python 3.2 introduced the *Limited API*, a subset of Python's C API. "
-"Extensions that only use the Limited API can be compiled once and work with "
-"multiple versions of Python. Contents of the Limited API are :ref:`listed "
+"Extensions that only use the Limited API can be compiled once and be loaded "
+"on multiple versions of Python. Contents of the Limited API are :ref:`listed "
 "below <limited-api-list>`."
 msgstr ""
 "Python 3.2 引入了\\ *受限 API (Limited API)*，它是 Python C API 的一個子集。"
@@ -150,12 +151,12 @@ msgstr ""
 "在包含 ``Python.h`` 之前定義此巨集以選擇只使用受限 API，並挑選受限 API 版本。"
 
 #: ../../c-api/stable.rst:77
+#, fuzzy
 msgid ""
 "Define ``Py_LIMITED_API`` to the value of :c:macro:`PY_VERSION_HEX` "
 "corresponding to the lowest Python version your extension supports. The "
-"extension will work without recompilation with all Python 3 releases from "
-"the specified one onward, and can use Limited API introduced up to that "
-"version."
+"extension will be ABI-compatible with all Python 3 releases from the "
+"specified one onward, and can use Limited API introduced up to that version."
 msgstr ""
 "將 ``Py_LIMITED_API`` 定義為對應於你的擴充有支援的最低 Python 版本的 :c:"
 "macro:`PY_VERSION_HEX` 值。該擴充無需重新編譯即可與從指定版本開始的所有 "
@@ -184,14 +185,24 @@ msgid "Stable ABI"
 msgstr "穩定 ABI"
 
 #: ../../c-api/stable.rst:96
+#, fuzzy
 msgid ""
 "To enable this, Python provides a *Stable ABI*: a set of symbols that will "
-"remain compatible across Python 3.x versions."
+"remain ABI-compatible across Python 3.x versions."
 msgstr ""
 "為了實現它，Python 提供了一個\\ *穩定 ABI (Stable ABI)*：一組將在各個 Python "
 "3.x 版本之間保持相容的符號。"
 
-#: ../../c-api/stable.rst:99
+#: ../../c-api/stable.rst:101
+msgid ""
+"The Stable ABI prevents ABI issues, like linker errors due to missing "
+"symbols or data corruption due to changes in structure layouts or function "
+"signatures. However, other changes in Python can change the *behavior* of "
+"extensions. See Python's Backwards Compatibility Policy (:pep:`387`) for "
+"details."
+msgstr ""
+
+#: ../../c-api/stable.rst:107
 msgid ""
 "The Stable ABI contains symbols exposed in the :ref:`Limited API <limited-c-"
 "api>`, but also other ones – for example, functions necessary to support "
@@ -200,7 +211,7 @@ msgstr ""
 "穩定 ABI 被包含在\\ :ref:`受限 API <limited-c-api>` 中開放的符號，但也包含其"
 "他符號 - 例如，支援舊版受限 API 所必需的函式。"
 
-#: ../../c-api/stable.rst:103
+#: ../../c-api/stable.rst:111
 msgid ""
 "On Windows, extensions that use the Stable ABI should be linked against "
 "``python3.dll`` rather than a version-specific library such as ``python39."
@@ -209,7 +220,7 @@ msgstr ""
 "在 Windows 上，使用穩定 ABI 的擴充應該連接到 ``python3.dll`` 而不是特定版本的"
 "函式庫，例如 ``python39.dll``。"
 
-#: ../../c-api/stable.rst:107
+#: ../../c-api/stable.rst:115
 msgid ""
 "On some platforms, Python will look for and load shared library files named "
 "with the ``abi3`` tag (e.g. ``mymodule.abi3.so``). It does not check if such "
@@ -222,7 +233,7 @@ msgstr ""
 "用者（或者打包工具）身上，例如使用 3.10+ 受限 API 建置的擴充不會為較低版本的 "
 "Python 所安裝。"
 
-#: ../../c-api/stable.rst:114
+#: ../../c-api/stable.rst:122
 msgid ""
 "All functions in the Stable ABI are present as functions in Python's shared "
 "library, not solely as macros. This makes them usable from languages that "
@@ -231,18 +242,18 @@ msgstr ""
 "穩定 ABI 中的所有函式都作為函式存在於 Python 的共享函式庫中，而不僅是作為巨"
 "集。這使得它們可被用於不使用 C 預處理器 (preprocessor) 的語言。"
 
-#: ../../c-api/stable.rst:120
+#: ../../c-api/stable.rst:128
 msgid "Limited API Scope and Performance"
 msgstr "受限 API 範圍和性能"
 
-#: ../../c-api/stable.rst:122
+#: ../../c-api/stable.rst:130
 msgid ""
 "The goal for the Limited API is to allow everything that is possible with "
 "the full C API, but possibly with a performance penalty."
 msgstr ""
 "受限 API 的目標是允許使用完整的 C API 進行所有可能的操作，但可能會降低性能。"
 
-#: ../../c-api/stable.rst:125
+#: ../../c-api/stable.rst:133
 msgid ""
 "For example, while :c:func:`PyList_GetItem` is available, its “unsafe” macro "
 "variant :c:func:`PyList_GET_ITEM` is not. The macro can be faster because it "
@@ -252,7 +263,7 @@ msgstr ""
 "`PyList_GET_ITEM` 為不可用。巨集運行可以更快，因為它可以依賴 list 物件的特定"
 "版本實作細節。"
 
-#: ../../c-api/stable.rst:130
+#: ../../c-api/stable.rst:138
 msgid ""
 "Without ``Py_LIMITED_API`` defined, some C API functions are inlined or "
 "replaced by macros. Defining ``Py_LIMITED_API`` disables this inlining, "
@@ -263,7 +274,7 @@ msgstr ""
 "``Py_LIMITED_API`` 會禁用嵌入，從而隨著 Python 資料結構的改進而提高穩定性，但"
 "可能會降低性能。"
 
-#: ../../c-api/stable.rst:135
+#: ../../c-api/stable.rst:143
 msgid ""
 "By leaving out the ``Py_LIMITED_API`` definition, it is possible to compile "
 "a Limited API extension with a version-specific ABI. This can improve "
@@ -277,11 +288,11 @@ msgstr ""
 "將產生一個擴充，可以在特定版本的擴充不可用的地方發布 — 例如，用於即將發布的 "
 "Python 版本的預發布版本 (prerelease)。"
 
-#: ../../c-api/stable.rst:144
+#: ../../c-api/stable.rst:152
 msgid "Limited API Caveats"
 msgstr "受限 API 注意事項"
 
-#: ../../c-api/stable.rst:146
+#: ../../c-api/stable.rst:154
 msgid ""
 "Note that compiling with ``Py_LIMITED_API`` is *not* a complete guarantee "
 "that code conforms to the :ref:`Limited API <limited-c-api>` or the :ref:"
@@ -293,7 +304,7 @@ msgstr ""
 "``Py_LIMITED_API`` 僅涵蓋定義，但 API 還包括其他議題，例如預期的語義 "
 "(semantic)。"
 
-#: ../../c-api/stable.rst:151
+#: ../../c-api/stable.rst:159
 msgid ""
 "One issue that ``Py_LIMITED_API`` does not guard against is calling a "
 "function with arguments that are invalid in a lower Python version. For "
@@ -307,23 +318,23 @@ msgstr ""
 "現在代表選擇預設行為，但在 Python 3.8 中，引數將被直接使用，導致 ``NULL`` 取"
 "消參照 (dereference) 且崩潰 (crash)。類似的引數適用於結構 (struct) 的欄位。"
 
-#: ../../c-api/stable.rst:158
+#: ../../c-api/stable.rst:166
 msgid ""
 "Another issue is that some struct fields are currently not hidden when "
 "``Py_LIMITED_API`` is defined, even though they're part of the Limited API."
 msgstr ""
 "另一個問題是，當有定義 ``Py_LIMITED_API`` 時，一些結構欄位目前不會被隱藏，即"
 "使它們是受限 API 的一部分。"
 
-#: ../../c-api/stable.rst:161
+#: ../../c-api/stable.rst:169
 msgid ""
 "For these reasons, we recommend testing an extension with *all* minor Python "
 "versions it supports, and preferably to build with the *lowest* such version."
 msgstr ""
 "出於這些原因，我們建議要以它支援的\\ *所有*\\ 次要 Python 版本來測試擴充，並"
 "且最好使用\\ *最低*\\ 版本進行建置。"
 
-#: ../../c-api/stable.rst:164
+#: ../../c-api/stable.rst:172
 msgid ""
 "We also recommend reviewing documentation of all used API to check if it is "
 "explicitly part of the Limited API. Even with ``Py_LIMITED_API`` defined, a "
@@ -334,7 +345,7 @@ msgstr ""
 "義 ``Py_LIMITED_API``，一些私有聲明也會因為技術原因（或者甚至是無意地，例如臭"
 "蟲）而被公開出來。"
 
-#: ../../c-api/stable.rst:169
+#: ../../c-api/stable.rst:177
 msgid ""
 "Also note that the Limited API is not necessarily stable: compiling with "
 "``Py_LIMITED_API`` with Python 3.8 means that the extension will run with "
@@ -346,11 +357,11 @@ msgstr ""
 "行編譯意味著擴充將能以 Python 3.12 運行，但不一定能以 Python 3.12 *編譯*。特"
 "別是如果穩定 ABI 保持穩定，部分受限 API 可能會被棄用和刪除。"
 
-#: ../../c-api/stable.rst:179
+#: ../../c-api/stable.rst:187
 msgid "Platform Considerations"
 msgstr "平台注意事項"
 
-#: ../../c-api/stable.rst:181
+#: ../../c-api/stable.rst:189
 msgid ""
 "ABI stability depends not only on Python, but also on the compiler used, "
 "lower-level libraries and compiler options. For the purposes of the :ref:"
@@ -361,7 +372,7 @@ msgstr ""
 "於\\ :ref:`穩定 ABI <stable-abi>` 的目的，這些細節定義了一個「平台」。它們通"
 "常取決於作業系統種類和處理器架構"
 
-#: ../../c-api/stable.rst:186
+#: ../../c-api/stable.rst:194
 msgid ""
 "It is the responsibility of each particular distributor of Python to ensure "
 "that all Python versions on a particular platform are built in a way that "
@@ -372,11 +383,11 @@ msgstr ""
 "定 ABI 的方式建置。``python.org`` 和許多第三方發布者發布的 Windows 和 macOS "
 "版本就是這種情況。"
 
-#: ../../c-api/stable.rst:196
+#: ../../c-api/stable.rst:204
 msgid "Contents of Limited API"
 msgstr "受限 API 的內容"
 
-#: ../../c-api/stable.rst:199
+#: ../../c-api/stable.rst:207
 msgid ""
 "Currently, the :ref:`Limited API <limited-c-api>` includes the following "
 "items:"