Sync with CPython 3.13

c-api/allocation.po

@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-06 00:13+0000\n"
+"POT-Creation-Date: 2025-03-18 00:14+0000\n"
 "PO-Revision-Date: 2022-10-16 15:35+0800\n"
 "Last-Translator: Matt Wang <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -56,7 +56,14 @@ msgstr ""
 "化；呼叫者會擁有那個對於物件的唯一參照（物件的參照計數為一）。記憶體分配大小"
 "由 type 物件的 :c:member:`~PyTypeObject.tp_basicsize` 欄位來指定。"
 
-#: ../../c-api/allocation.rst:41
+#: ../../c-api/allocation.rst:38
+msgid ""
+"Note that this function is unsuitable if *typeobj* has :c:macro:"
+"`Py_TPFLAGS_HAVE_GC` set. For such objects, use :c:func:`PyObject_GC_New` "
+"instead."
+msgstr ""
+
+#: ../../c-api/allocation.rst:45
 msgid ""
 "Allocate a new Python object using the C structure type *TYPE* and the "
 "Python type object *typeobj* (``PyTypeObject*``). Fields not defined by the "
@@ -75,7 +82,14 @@ msgstr ""
 "於實現如 tuple 這種能夠在建立期間決定自己大小的物件是很實用的。將欄位的陣列嵌"
 "入到相同的記憶體分配中可以減少記憶體分配的次數，這提高了記憶體管理的效率。"
 
-#: ../../c-api/allocation.rst:55
+#: ../../c-api/allocation.rst:56
+msgid ""
+"Note that this function is unsuitable if *typeobj* has :c:macro:"
+"`Py_TPFLAGS_HAVE_GC` set. For such objects, use :c:func:`PyObject_GC_NewVar` "
+"instead."
+msgstr ""
+
+#: ../../c-api/allocation.rst:63
 msgid ""
 "Releases memory allocated to an object using :c:macro:`PyObject_New` or :c:"
 "macro:`PyObject_NewVar`.  This is normally called from the :c:member:"
@@ -88,7 +102,7 @@ msgstr ""
 "handler 中呼叫。呼叫這個函式以後，物件的各欄位都不可以被存取，因為原本分配的"
 "記憶體已不再是一個有效的 Python 物件。"
 
-#: ../../c-api/allocation.rst:64
+#: ../../c-api/allocation.rst:72
 msgid ""
 "Object which is visible in Python as ``None``.  This should only be accessed "
 "using the :c:macro:`Py_None` macro, which evaluates to a pointer to this "
@@ -97,10 +111,10 @@ msgstr ""
 "這個物件像是 Python 中的 ``None``。它只應該透過 :c:macro:`Py_None` 巨集來存"
 "取，該巨集的拿到指向該物件的指標。"
 
-#: ../../c-api/allocation.rst:71
+#: ../../c-api/allocation.rst:79
 msgid ":c:func:`PyModule_Create`"
 msgstr ":c:func:`PyModule_Create`"
 
-#: ../../c-api/allocation.rst:72
+#: ../../c-api/allocation.rst:80
 msgid "To allocate and create extension modules."
 msgstr "分配記憶體和建立擴充模組。"

c-api/arg.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-01-07 00:14+0000\n"
+"POT-Creation-Date: 2025-03-03 00:15+0000\n"
 "PO-Revision-Date: 2022-10-16 03:21+0800\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -24,18 +24,18 @@ msgstr "剖析引數與建置數值"
 
 #: ../../c-api/arg.rst:8
 msgid ""
-"These functions are useful when creating your own extensions functions and "
-"methods.  Additional information and examples are available "
-"in :ref:`extending-index`."
+"These functions are useful when creating your own extension functions and "
+"methods.  Additional information and examples are available in :ref:"
+"`extending-index`."
 msgstr ""
 
 #: ../../c-api/arg.rst:12
 msgid ""
-"The first three of these functions "
-"described, :c:func:`PyArg_ParseTuple`, :c:func:`PyArg_ParseTupleAndKeywords`, "
-"and :c:func:`PyArg_Parse`, all use *format strings* which are used to tell "
-"the function about the expected arguments.  The format strings use the same "
-"syntax for each of these functions."
+"The first three of these functions described, :c:func:`PyArg_ParseTuple`, :c:"
+"func:`PyArg_ParseTupleAndKeywords`, and :c:func:`PyArg_Parse`, all use "
+"*format strings* which are used to tell the function about the expected "
+"arguments.  The format strings use the same syntax for each of these "
+"functions."
 msgstr ""
 
 #: ../../c-api/arg.rst:19
@@ -108,10 +108,10 @@ msgstr ""
 
 #: ../../c-api/arg.rst:70
 msgid ""
-"To ensure that the underlying buffer may be safely borrowed, the "
-"object's :c:member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. "
-"This disallows common mutable objects such as :class:`bytearray`, but also "
-"some read-only objects such as :class:`memoryview` of :class:`bytes`."
+"To ensure that the underlying buffer may be safely borrowed, the object's :c:"
+"member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. This "
+"disallows common mutable objects such as :class:`bytearray`, but also some "
+"read-only objects such as :class:`memoryview` of :class:`bytes`."
 msgstr ""
 
 #: ../../c-api/arg.rst:76
@@ -139,8 +139,8 @@ msgstr ""
 msgid ""
 "This format does not accept :term:`bytes-like objects <bytes-like object>`.  "
 "If you want to accept filesystem paths and convert them to C character "
-"strings, it is preferable to use the ``O&`` format "
-"with :c:func:`PyUnicode_FSConverter` as *converter*."
+"strings, it is preferable to use the ``O&`` format with :c:func:"
+"`PyUnicode_FSConverter` as *converter*."
 msgstr ""
 
 #: ../../c-api/arg.rst:96
@@ -163,11 +163,11 @@ msgstr ""
 
 #: ../../c-api/arg.rst:106
 msgid ""
-"``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char "
-"\\*, :c:type:`Py_ssize_t`]"
+"``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char \\*, :"
+"c:type:`Py_ssize_t`]"
 msgstr ""
-"``s#`` (:class:`str`、唯讀的 :term:`bytes-like object`) [const char "
-"\\*, :c:type:`Py_ssize_t`]"
+"``s#`` (:class:`str`、唯讀的 :term:`bytes-like object`) [const char \\*, :c:"
+"type:`Py_ssize_t`]"
 
 #: ../../c-api/arg.rst:107
 msgid ""
@@ -244,11 +244,11 @@ msgstr ""
 
 #: ../../c-api/arg.rst:141
 msgid ""
-"``y#`` (read-only :term:`bytes-like object`) [const char "
-"\\*, :c:type:`Py_ssize_t`]"
+"``y#`` (read-only :term:`bytes-like object`) [const char \\*, :c:type:"
+"`Py_ssize_t`]"
 msgstr ""
-"``y#`` (唯讀的 :term:`bytes-like object`) [const char "
-"\\*, :c:type:`Py_ssize_t`]"
+"``y#`` (唯讀的 :term:`bytes-like object`) [const char \\*, :c:type:"
+"`Py_ssize_t`]"
 
 #: ../../c-api/arg.rst:142
 msgid ""
@@ -274,9 +274,9 @@ msgstr "``Y`` (:class:`bytearray`) [PyByteArrayObject \\*]"
 #: ../../c-api/arg.rst:151
 msgid ""
 "Requires that the Python object is a :class:`bytearray` object, without "
-"attempting any conversion.  Raises :exc:`TypeError` if the object is not "
-"a :class:`bytearray` object. The C variable may also be declared "
-"as :c:expr:`PyObject*`."
+"attempting any conversion.  Raises :exc:`TypeError` if the object is not a :"
+"class:`bytearray` object. The C variable may also be declared as :c:expr:"
+"`PyObject*`."
 msgstr ""
 
 #: ../../c-api/arg.rst:155
@@ -298,8 +298,8 @@ msgstr "``w*`` (可讀寫 :term:`bytes-like object`) [Py_buffer]"
 msgid ""
 "This format accepts any object which implements the read-write buffer "
 "interface. It fills a :c:type:`Py_buffer` structure provided by the caller. "
-"The buffer may contain embedded null bytes. The caller have to "
-"call :c:func:`PyBuffer_Release` when it is done with the buffer."
+"The buffer may contain embedded null bytes. The caller have to call :c:func:"
+"`PyBuffer_Release` when it is done with the buffer."
 msgstr ""
 
 #: ../../c-api/arg.rst:166
@@ -327,8 +327,8 @@ msgstr ""
 msgid ""
 ":c:func:`PyArg_ParseTuple` will allocate a buffer of the needed size, copy "
 "the encoded data into this buffer and adjust *\\*buffer* to reference the "
-"newly allocated storage.  The caller is responsible for "
-"calling :c:func:`PyMem_Free` to free the allocated buffer after use."
+"newly allocated storage.  The caller is responsible for calling :c:func:"
+"`PyMem_Free` to free the allocated buffer after use."
 msgstr ""
 
 #: ../../c-api/arg.rst:183
@@ -348,11 +348,11 @@ msgstr ""
 
 #: ../../c-api/arg.rst:188
 msgid ""
-"``es#`` (:class:`str`) [const char \\*encoding, char "
-"\\*\\*buffer, :c:type:`Py_ssize_t` \\*buffer_length]"
+"``es#`` (:class:`str`) [const char \\*encoding, char \\*\\*buffer, :c:type:"
+"`Py_ssize_t` \\*buffer_length]"
 msgstr ""
-"``es#`` (:class:`str`) [const char \\*encoding, char "
-"\\*\\*buffer, :c:type:`Py_ssize_t` \\*buffer_length]"
+"``es#`` (:class:`str`) [const char \\*encoding, char \\*\\*buffer, :c:type:"
+"`Py_ssize_t` \\*buffer_length]"
 
 #: ../../c-api/arg.rst:189
 msgid ""
@@ -428,11 +428,10 @@ msgstr "數字"
 #: ../../c-api/arg.rst:232
 msgid ""
 "These formats allow representing Python numbers or single characters as C "
-"numbers. Formats that require :class:`int`, :class:`float` "
-"or :class:`complex` can also use the corresponding special "
-"methods :meth:`~object.__index__`, :meth:`~object.__float__` "
-"or :meth:`~object.__complex__` to convert the Python object to the required "
-"type."
+"numbers. Formats that require :class:`int`, :class:`float` or :class:"
+"`complex` can also use the corresponding special methods :meth:`~object."
+"__index__`, :meth:`~object.__float__` or :meth:`~object.__complex__` to "
+"convert the Python object to the required type."
 msgstr ""
 
 #: ../../c-api/arg.rst:238
@@ -452,8 +451,8 @@ msgid ""
 "Convert a nonnegative Python integer to an unsigned tiny integer, stored in "
 "a C :c:expr:`unsigned char`."
 msgstr ""
-"將一個 Python 非負整數轉換成無符號 tiny integer（小整數），儲存在 C "
-"的 :c:expr:`unsigned`"
+"將一個 Python 非負整數轉換成無符號 tiny integer（小整數），儲存在 C 的 :c:"
+"expr:`unsigned`"
 
 #: ../../c-api/arg.rst:248 ../../c-api/arg.rst:627
 msgid "``B`` (:class:`int`) [unsigned char]"
@@ -464,8 +463,8 @@ msgid ""
 "Convert a Python integer to a tiny integer without overflow checking, stored "
 "in a C :c:expr:`unsigned char`."
 msgstr ""
-"將一個 Python 整數轉換成 tiny integer，轉換過程無溢位檢查，儲存在 C "
-"的 :c:expr:`unsigned char`。"
+"將一個 Python 整數轉換成 tiny integer，轉換過程無溢位檢查，儲存在 C 的 :c:"
+"expr:`unsigned char`。"
 
 #: ../../c-api/arg.rst:252 ../../c-api/arg.rst:621
 msgid "``h`` (:class:`int`) [short int]"
@@ -612,9 +611,9 @@ msgstr "``O`` (object) [PyObject \\*]"
 #: ../../c-api/arg.rst:307
 msgid ""
 "Store a Python object (without any conversion) in a C object pointer.  The C "
-"program thus receives the actual object that was passed.  A "
-"new :term:`strong reference` to the object is not created (i.e. its "
-"reference count is not increased). The pointer stored is not ``NULL``."
+"program thus receives the actual object that was passed.  A new :term:"
+"`strong reference` to the object is not created (i.e. its reference count is "
+"not increased). The pointer stored is not ``NULL``."
 msgstr ""
 
 #: ../../c-api/arg.rst:313
@@ -648,12 +647,12 @@ msgstr "status = converter(object, address);"
 
 #: ../../c-api/arg.rst:330
 msgid ""
-"where *object* is the Python object to be converted and *address* is "
-"the :c:expr:`void*` argument that was passed to the ``PyArg_Parse*`` "
-"function. The returned *status* should be ``1`` for a successful conversion "
-"and ``0`` if the conversion has failed.  When the conversion fails, the "
-"*converter* function should raise an exception and leave the content of "
-"*address* unmodified."
+"where *object* is the Python object to be converted and *address* is the :c:"
+"expr:`void*` argument that was passed to the ``PyArg_Parse*`` function. The "
+"returned *status* should be ``1`` for a successful conversion and ``0`` if "
+"the conversion has failed.  When the conversion fails, the *converter* "
+"function should raise an exception and leave the content of *address* "
+"unmodified."
 msgstr ""
 
 #: ../../c-api/arg.rst:339
@@ -667,8 +666,8 @@ msgstr ""
 
 #: ../../c-api/arg.rst:345
 msgid ""
-"Examples of converters: :c:func:`PyUnicode_FSConverter` "
-"and :c:func:`PyUnicode_FSDecoder`."
+"Examples of converters: :c:func:`PyUnicode_FSConverter` and :c:func:"
+"`PyUnicode_FSDecoder`."
 msgstr ""
 
 #: ../../c-api/arg.rst:348
@@ -748,8 +747,8 @@ msgstr "``;``"
 #: ../../c-api/arg.rst:390
 msgid ""
 "The list of format units ends here; the string after the semicolon is used "
-"as the error message *instead* of the default error message.  ``:`` and "
-"``;`` mutually exclude each other."
+"as the error message *instead* of the default error message.  ``:`` and ``;"
+"`` mutually exclude each other."
 msgstr ""
 
 #: ../../c-api/arg.rst:394
@@ -808,9 +807,9 @@ msgstr ""
 
 #: ../../c-api/arg.rst:441
 msgid ""
-"The *keywords* parameter declaration is :c:expr:`char * const *` in C "
-"and :c:expr:`const char * const *` in C++. This can be overridden with "
-"the :c:macro:`PY_CXX_CONST` macro."
+"The *keywords* parameter declaration is :c:expr:`char * const *` in C and :c:"
+"expr:`const char * const *` in C++. This can be overridden with the :c:macro:"
+"`PY_CXX_CONST` macro."
 msgstr ""
 
 #: ../../c-api/arg.rst:445
@@ -821,9 +820,9 @@ msgstr "新增對\\ :ref:`僅限位置參數 <positional-only_parameter>`\\ 的
 
 #: ../../c-api/arg.rst:449
 msgid ""
-"The *keywords* parameter has now type :c:expr:`char * const *` in C "
-"and :c:expr:`const char * const *` in C++, instead of :c:expr:`char **`. "
-"Added support for non-ASCII keyword parameter names."
+"The *keywords* parameter has now type :c:expr:`char * const *` in C and :c:"
+"expr:`const char * const *` in C++, instead of :c:expr:`char **`. Added "
+"support for non-ASCII keyword parameter names."
 msgstr ""
 
 #: ../../c-api/arg.rst:458
@@ -961,10 +960,10 @@ msgid ""
 "When memory buffers are passed as parameters to supply data to build "
 "objects, as for the ``s`` and ``s#`` formats, the required data is copied.  "
 "Buffers provided by the caller are never referenced by the objects created "
-"by :c:func:`Py_BuildValue`.  In other words, if your code "
-"invokes :c:func:`malloc` and passes the allocated memory "
-"to :c:func:`Py_BuildValue`, your code is responsible for "
-"calling :c:func:`free` for that memory once :c:func:`Py_BuildValue` returns."
+"by :c:func:`Py_BuildValue`.  In other words, if your code invokes :c:func:"
+"`malloc` and passes the allocated memory to :c:func:`Py_BuildValue`, your "
+"code is responsible for calling :c:func:`free` for that memory once :c:func:"
+"`Py_BuildValue` returns."
 msgstr ""
 
 #: ../../c-api/arg.rst:568
@@ -1128,16 +1127,16 @@ msgid ""
 "Convert a C :c:expr:`int` representing a byte to a Python :class:`bytes` "
 "object of length 1."
 msgstr ""
-"將一個 C 中代表一個位元組的 :c:expr:`int` 轉換成 Python 中長度為一"
-"的 :class:`bytes`。"
+"將一個 C 中代表一個位元組的 :c:expr:`int` 轉換成 Python 中長度為一的 :class:"
+"`bytes`。"
 
 #: ../../c-api/arg.rst:653
 msgid ""
 "Convert a C :c:expr:`int` representing a character to Python :class:`str` "
 "object of length 1."
 msgstr ""
-"將一個 C 中代表一個字元的 :c:expr:`int` 轉換成 Python 中長度為一"
-"的 :class:`str`。"
+"將一個 C 中代表一個字元的 :c:expr:`int` 轉換成 Python 中長度為一的 :class:"
+"`str`。"
 
 #: ../../c-api/arg.rst:657
 msgid "Convert a C :c:expr:`double` to a Python floating-point number."
@@ -1160,9 +1159,9 @@ msgid ""
 "Pass a Python object untouched but create a new :term:`strong reference` to "
 "it (i.e. its reference count is incremented by one). If the object passed in "
 "is a ``NULL`` pointer, it is assumed that this was caused because the call "
-"producing the argument found an error and set an exception. "
-"Therefore, :c:func:`Py_BuildValue` will return ``NULL`` but won't raise an "
-"exception.  If no exception has been raised yet, :exc:`SystemError` is set."
+"producing the argument found an error and set an exception. Therefore, :c:"
+"func:`Py_BuildValue` will return ``NULL`` but won't raise an exception.  If "
+"no exception has been raised yet, :exc:`SystemError` is set."
 msgstr ""
 
 #: ../../c-api/arg.rst:675
@@ -1191,9 +1190,9 @@ msgstr "``O&`` (object) [*converter*, *anything*]"
 #: ../../c-api/arg.rst:684
 msgid ""
 "Convert *anything* to a Python object through a *converter* function.  The "
-"function is called with *anything* (which should be compatible "
-"with :c:expr:`void*`) as its argument and should return a \"new\" Python "
-"object, or ``NULL`` if an error occurred."
+"function is called with *anything* (which should be compatible with :c:expr:"
+"`void*`) as its argument and should return a \"new\" Python object, or "
+"``NULL`` if an error occurred."
 msgstr ""
 
 #: ../../c-api/arg.rst:690