Skip to content

Sync with CPython 3.14 #1193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
pydoc-zh-tw wants to merge 6 commits into
base: 3.14
Choose a base branch
from
Draft

Sync with CPython 3.14 #1193

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
e4f5596
sync with cpython fbc81558
github-actions[bot] Jan 22, 2026
f103aad
sync with cpython f3a6e8ed
github-actions[bot] Jan 24, 2026
8c0fd99
sync with cpython c5b23ebc
github-actions[bot] Jan 27, 2026
f221102
sync with cpython b82b12bc
github-actions[bot] Jan 28, 2026
6f2560b
fix fuzzy entries
mattwang44 Feb 1, 2026
dbfee6f
sync with cpython f68d634d
github-actions[bot] Feb 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions c-api/bytes.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-12-01 00:17+0000\n"
"POT-Creation-Date: 2026-01-22 16:55+0000\n"
"PO-Revision-Date: 2018-05-23 14:04+0000\n"
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
Expand Down Expand Up @@ -159,8 +159,8 @@ msgid "``%zd``"
msgstr "``%zd``"

#: ../../c-api/bytes.rst:84
msgid ":c:type:` Py_ssize_t`"
msgstr ":c:type:` Py_ssize_t`"
msgid ":c:type:`\\ Py_ssize_t`"
msgstr ":c:type:`\\ Py_ssize_t`"

#: ../../c-api/bytes.rst:84
msgid "Equivalent to ``printf(\"%zd\")``. [1]_"
Expand Down
30 changes: 17 additions & 13 deletions c-api/module.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-11-27 00:14+0000\n"
"POT-Creation-Date: 2026-01-28 00:16+0000\n"
"PO-Revision-Date: 2018-05-23 14:32+0000\n"
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
Expand Down Expand Up @@ -784,7 +784,11 @@ msgid ""
"``PyModule_FromDefAndSpec``)."
msgstr ""

#: ../../c-api/module.rst:682
#: ../../c-api/module.rst:678
msgid "Return ``0`` on success. Return ``-1`` with an exception set on error."
msgstr "成功時回傳 ``0``。在失敗時回傳 ``-1`` 並設定例外。"

#: ../../c-api/module.rst:685
msgid ""
"Indicate that *module* does or does not support running without the global "
"interpreter lock (GIL), using one of the values from :c:macro:`Py_mod_gil`. "
Expand All @@ -796,26 +800,26 @@ msgid ""
"on error, ``0`` on success."
msgstr ""

#: ../../c-api/module.rst:696
#: ../../c-api/module.rst:699
msgid "Module lookup (single-phase initialization)"
msgstr ""

#: ../../c-api/module.rst:698
#: ../../c-api/module.rst:701
msgid ""
"The legacy :ref:`single-phase initialization <single-phase-initialization>` "
"initialization scheme creates singleton modules that can be looked up in the "
"context of the current interpreter. This allows the module object to be "
"retrieved later with only a reference to the module definition."
msgstr ""

#: ../../c-api/module.rst:703
#: ../../c-api/module.rst:706
msgid ""
"These functions will not work on modules created using multi-phase "
"initialization, since multiple such modules can be created from a single "
"definition."
msgstr ""

#: ../../c-api/module.rst:708
#: ../../c-api/module.rst:711
msgid ""
"Returns the module object that was created from *def* for the current "
"interpreter. This method requires that the module object has been attached "
Expand All @@ -824,18 +828,18 @@ msgid ""
"to the interpreter state yet, it returns ``NULL``."
msgstr ""

#: ../../c-api/module.rst:715
#: ../../c-api/module.rst:718
msgid ""
"Attaches the module object passed to the function to the interpreter state. "
"This allows the module object to be accessible via :c:func:"
"`PyState_FindModule`."
msgstr ""

#: ../../c-api/module.rst:718
#: ../../c-api/module.rst:721
msgid "Only effective on modules created using single-phase initialization."
msgstr ""

#: ../../c-api/module.rst:720
#: ../../c-api/module.rst:723
msgid ""
"Python calls ``PyState_AddModule`` automatically after importing a module "
"that uses :ref:`single-phase initialization <single-phase-initialization>`, "
Expand All @@ -847,21 +851,21 @@ msgid ""
"state updates)."
msgstr ""

#: ../../c-api/module.rst:729
#: ../../c-api/module.rst:732
msgid ""
"If a module was attached previously using the same *def*, it is replaced by "
"the new *module*."
msgstr ""

#: ../../c-api/module.rst:732 ../../c-api/module.rst:743
#: ../../c-api/module.rst:735 ../../c-api/module.rst:746
msgid "The caller must have an :term:`attached thread state`."
msgstr ""

#: ../../c-api/module.rst:734
#: ../../c-api/module.rst:737
msgid "Return ``-1`` with an exception set on error, ``0`` on success."
msgstr "成功時回傳 ``0``，在失敗時回傳 ``-1`` 並設定例外。"

#: ../../c-api/module.rst:740
#: ../../c-api/module.rst:743
msgid ""
"Removes the module object created from *def* from the interpreter state. "
"Return ``-1`` with an exception set on error, ``0`` on success."
Expand Down
16 changes: 8 additions & 8 deletions c-api/object.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-11-05 00:16+0000\n"
"POT-Creation-Date: 2026-02-03 00:20+0000\n"
"PO-Revision-Date: 2018-05-23 14:32+0000\n"
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
Expand Down Expand Up @@ -821,14 +821,14 @@ msgstr ""
#: ../../c-api/object.rst:668
msgid ""
":c:func:`PyUnstable_EnableTryIncRef` must have been called earlier on *obj* "
"or this function may spuriously return ``0`` in the :term:`free threading` "
"build."
"or this function may spuriously return ``0`` in the :term:`free-threaded "
"build`."
msgstr ""

#: ../../c-api/object.rst:672
msgid ""
"This function is logically equivalent to the following C code, except that "
"it behaves atomically in the :term:`free threading` build::"
"it behaves atomically in the :term:`free-threaded build`::"
msgstr ""

#: ../../c-api/object.rst:675
Expand Down Expand Up @@ -922,10 +922,10 @@ msgstr ""

#: ../../c-api/object.rst:750
msgid ""
"On a :term:`free threaded <free threading>` build, this checks if *op*'s :"
"term:`reference count` is equal to one and additionally checks if *op* is "
"only used by this thread. :c:expr:`Py_REFCNT(op) == 1` is **not** thread-"
"safe on free threaded builds; prefer this function."
"On a :term:`free-threaded build`, this checks if *op*'s :term:`reference "
"count` is equal to one and additionally checks if *op* is only used by this "
"thread. :c:expr:`Py_REFCNT(op) == 1` is **not** thread-safe on free-threaded "
"builds; prefer this function."
msgstr ""

#: ../../c-api/object.rst:755
Expand Down
78 changes: 38 additions & 40 deletions c-api/refcounting.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-09-08 15:25+0800\n"
"POT-Creation-Date: 2026-02-03 00:20+0000\n"
"PO-Revision-Date: 2023-08-06 14:19+0800\n"
"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
Expand Down Expand Up @@ -37,10 +37,10 @@ msgstr "取得物件 *o* 的參照計數。"
#: ../../c-api/refcounting.rst:18
msgid ""
"Note that the returned value may not actually reflect how many references to "
"the object are actually held. For example, some objects "
"are :term:`immortal` and have a very high refcount that does not reflect the "
"actual number of references. Consequently, do not rely on the returned "
"value to be accurate, other than a value of 0 or 1."
"the object are actually held. For example, some objects are :term:"
"`immortal` and have a very high refcount that does not reflect the actual "
"number of references. Consequently, do not rely on the returned value to be "
"accurate, other than a value of 0 or 1."
msgstr ""
"請注意，回傳的值可能實際上並不反映實際保存了多少對該物件的參照。例如，某些物"
"件是「:term:`不滅的 (immortal) <immortal>`」，並且具有非常高的參照計數，不能"
Expand All @@ -53,16 +53,16 @@ msgstr "使用 :c:func:`Py_SET_REFCNT()` 函式設定物件參照計數。"

#: ../../c-api/refcounting.rst:28
msgid ""
"On :term:`free threaded <free threading>` builds of Python, returning 1 "
"On :term:`free-threaded builds <free-threaded build>` of Python, returning 1 "
"isn't sufficient to determine if it's safe to treat *o* as having no access "
"by other threads. Use :c:func:`PyUnstable_Object_IsUniquelyReferenced` for "
"that instead."
msgstr ""

#: ../../c-api/refcounting.rst:33
msgid ""
"See also the "
"function :c:func:`PyUnstable_Object_IsUniqueReferencedTemporary()`."
"See also the function :c:func:"
"`PyUnstable_Object_IsUniqueReferencedTemporary()`."
msgstr ""

#: ../../c-api/refcounting.rst:35
Expand Down Expand Up @@ -106,8 +106,8 @@ msgstr ""

#: ../../c-api/refcounting.rst:64
msgid ""
"This function is usually used to convert a :term:`borrowed reference` to "
"a :term:`strong reference` in-place. The :c:func:`Py_NewRef` function can be "
"This function is usually used to convert a :term:`borrowed reference` to a :"
"term:`strong reference` in-place. The :c:func:`Py_NewRef` function can be "
"used to create a new :term:`strong reference`."
msgstr ""
"此函式通常用於將\\ :term:`借用參照 <borrowed reference>`\\ 原地 (in-place) 轉"
Expand All @@ -123,13 +123,13 @@ msgid ""
"The object must not be ``NULL``; if you aren't sure that it isn't ``NULL``, "
"use :c:func:`Py_XINCREF`."
msgstr ""
"該物件不能為 ``NULL``；如果你不確定它不是 ``NULL``，請使"
"用 :c:func:`Py_XINCREF`。"
"該物件不能為 ``NULL``；如果你不確定它不是 ``NULL``，請使用 :c:func:"
"`Py_XINCREF`。"

#: ../../c-api/refcounting.rst:73
msgid ""
"Do not expect this function to actually modify *o* in any way. For at "
"least :pep:`some objects <0683>`, this function has no effect."
"Do not expect this function to actually modify *o* in any way. For at least :"
"pep:`some objects <0683>`, this function has no effect."
msgstr ""
"不要期望此函式會以任何方式實際修改 *o*，至少對於\\ :pep:`某些物件 <0683>`\\ "
"來說，此函式沒有任何效果。"
Expand All @@ -151,24 +151,24 @@ msgid ""
"Create a new :term:`strong reference` to an object: call :c:func:`Py_INCREF` "
"on *o* and return the object *o*."
msgstr ""
"建立對物件的新\\ :term:`強參照 <strong reference>`：於 *o* 呼"
"叫 :c:func:`Py_INCREF` 並回傳物件 *o*。"
"建立對物件的新\\ :term:`強參照 <strong reference>`：於 *o* 呼叫 :c:func:"
"`Py_INCREF` 並回傳物件 *o*。"

#: ../../c-api/refcounting.rst:94
msgid ""
"When the :term:`strong reference` is no longer needed, :c:func:`Py_DECREF` "
"should be called on it to release the reference."
msgstr ""
"當不再需要\\ :term:`強參照 <strong reference>`\\ 時，應對其呼"
"叫 :c:func:`Py_DECREF` 以釋放該參照。"
"當不再需要\\ :term:`強參照 <strong reference>`\\ 時，應對其呼叫 :c:func:"
"`Py_DECREF` 以釋放該參照。"

#: ../../c-api/refcounting.rst:97
msgid ""
"The object *o* must not be ``NULL``; use :c:func:`Py_XNewRef` if *o* can be "
"``NULL``."
msgstr ""
"物件 *o* 不能為 ``NULL``；如果 *o* 可以為 ``NULL``，則使"
"用 :c:func:`Py_XNewRef`。"
"物件 *o* 不能為 ``NULL``；如果 *o* 可以為 ``NULL``，則使用 :c:func:"
"`Py_XNewRef`。"

#: ../../c-api/refcounting.rst:100
msgid "For example::"
Expand Down Expand Up @@ -232,21 +232,21 @@ msgid ""
"The object must not be ``NULL``; if you aren't sure that it isn't ``NULL``, "
"use :c:func:`Py_XDECREF`."
msgstr ""
"該物件不能為 ``NULL``；如果你不確定它不是 ``NULL``，請改"
"用 :c:func:`Py_XDECREF`。"
"該物件不能為 ``NULL``；如果你不確定它不是 ``NULL``，請改用 :c:func:"
"`Py_XDECREF`。"

#: ../../c-api/refcounting.rst:141
msgid ""
"Do not expect this function to actually modify *o* in any way. For at "
"least :pep:`some objects <683>`, this function has no effect."
"Do not expect this function to actually modify *o* in any way. For at least :"
"pep:`some objects <683>`, this function has no effect."
msgstr ""
"不要期望此函式會以任何方式實際修改 *o*，至少對於\\ :pep:`某些物件 <683>`\\ 來"
"說，此函式沒有任何效果。"

#: ../../c-api/refcounting.rst:147
msgid ""
"The deallocation function can cause arbitrary Python code to be invoked "
"(e.g. when a class instance with a :meth:`~object.__del__` method is "
"The deallocation function can cause arbitrary Python code to be invoked (e."
"g. when a class instance with a :meth:`~object.__del__` method is "
"deallocated). While exceptions in such code are not propagated, the "
"executed code has free access to all Python global variables. This means "
"that any object that is reachable from a global variable should be in a "
Expand All @@ -255,12 +255,12 @@ msgid ""
"object in a temporary variable, update the list data structure, and then "
"call :c:func:`Py_DECREF` for the temporary variable."
msgstr ""
"釋放函式可以導致任意 Python 程式碼被叫用（例如，當釋放具"
"有 :meth:`~object.__del__` 方法的類別實例時）。雖然此類程式碼中的例外不會被傳"
"遞出來，但​​執行的程式碼可以自由存取所有 Python 全域變數。這意味著在叫"
"用 :c:func:`Py_DECREF` 之前，可從全域變數存取的任何物件都應處於一致狀態。例"
"如，從 list 中刪除物件的程式碼應將已刪除物件的參照複製到臨時變數中，更新 "
"list 資料結構，然後為臨時變數呼叫 :c:func:`Py_DECREF`。"
"釋放函式可以導致任意 Python 程式碼被叫用（例如，當釋放具有 :meth:`~object."
"__del__` 方法的類別實例時）。雖然此類程式碼中的例外不會被傳遞出來，但​​執行的程"
"式碼可以自由存取所有 Python 全域變數。這意味著在叫用 :c:func:`Py_DECREF` 之"
"前，可從全域變數存取的任何物件都應處於一致狀態。例如，從 list 中刪除物件的程"
"式碼應將已刪除物件的參照複製到臨時變數中，更新 list 資料結構，然後為臨時變數"
"呼叫 :c:func:`Py_DECREF`。"

#: ../../c-api/refcounting.rst:162
msgid ""
Expand Down Expand Up @@ -307,15 +307,13 @@ msgid ""
"version of :c:func:`Py_XINCREF`. It can be used for runtime dynamic "
"embedding of Python."
msgstr ""
"代表取得對於物件 *o* 的\\ :term:`強參照 <strong "
"reference>`。:c:func:`Py_XINCREF` 的函式版本。它可用於 Python 的 runtime 動態"
"嵌入。"
"代表取得對於物件 *o* 的\\ :term:`強參照 <strong reference>`。:c:func:"
"`Py_XINCREF` 的函式版本。它可用於 Python 的 runtime 動態嵌入。"

#: ../../c-api/refcounting.rst:194
msgid ""
"Release a :term:`strong reference` to object *o*. A function version "
"of :c:func:`Py_XDECREF`. It can be used for runtime dynamic embedding of "
"Python."
"Release a :term:`strong reference` to object *o*. A function version of :c:"
"func:`Py_XDECREF`. It can be used for runtime dynamic embedding of Python."
msgstr ""
"釋放對物件 *o* 的\\ :term:`強參照 <strong reference>`。:c:func:`Py_XDECREF` "
"的函式版本。它可用於 Python 的 runtime 動態嵌入。"
Expand Down Expand Up @@ -369,5 +367,5 @@ msgid ""
"Variant of :c:macro:`Py_SETREF` macro that uses :c:func:`Py_XDECREF` instead "
"of :c:func:`Py_DECREF`."
msgstr ""
":c:macro:`Py_SETREF` 巨集的變體，請改用 :c:func:`Py_XDECREF` 而"
"非 :c:func:`Py_DECREF`。"
":c:macro:`Py_SETREF` 巨集的變體，請改用 :c:func:`Py_XDECREF` 而非 :c:func:"
"`Py_DECREF`。"
Loading