sync with cpython e6dfa9d6

Author: github-actions[bot]

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 <adrianliaw2000@gmail.com>\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