Skip to content

Sync with CPython 3.13 #1036

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

Closed
pydoc-zh-tw wants to merge 3 commits into from
Closed

Sync with CPython 3.13 #1036

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
56f280c
sync with cpython 1dfe5def
github-actions[bot] May 6, 2025
a73f683
sync with cpython fe184370
github-actions[bot] May 6, 2025
b58d3bb
fix: resolve fuzzy entries
mattwang44 May 6, 2025
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
151 changes: 76 additions & 75 deletions c-api/arg.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,17 +25,17 @@ msgstr "剖析引數與建置數值"
#: ../../c-api/arg.rst:8
msgid ""
"These functions are useful when creating your own extension functions and "
"methods. Additional information and examples are available in :ref:"
"`extending-index`."
"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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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 ""
Expand Down Expand Up @@ -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 ""
Expand All @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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 ""
Expand Down Expand Up @@ -428,10 +428,11 @@ 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
Expand All @@ -451,8 +452,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]"
Expand All @@ -463,8 +464,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]"
Expand Down Expand Up @@ -611,9 +612,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
Expand Down Expand Up @@ -647,12 +648,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
Expand All @@ -666,8 +667,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
Expand Down Expand Up @@ -747,8 +748,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
Expand Down Expand Up @@ -807,9 +808,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
Expand All @@ -820,9 +821,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
Expand Down Expand Up @@ -960,10 +961,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
Expand Down Expand Up @@ -1127,16 +1128,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:655
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:659
msgid "Convert a C :c:expr:`double` to a Python floating-point number."
Expand All @@ -1159,9 +1160,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:677
Expand All @@ -1179,8 +1180,8 @@ msgstr "``N`` (object) [PyObject \\*]"
#: ../../c-api/arg.rst:681
msgid ""
"Same as ``O``, except it doesn't create a new :term:`strong reference`. "
"Useful when the object is created by a call to an object constructor in the "
"argument list."
"Useful when the object is created by a call to an object in the argument "
"list."
msgstr ""

#: ../../c-api/arg.rst:685
Expand All @@ -1190,9 +1191,9 @@ msgstr "``O&`` (object) [*converter*, *anything*]"
#: ../../c-api/arg.rst:686
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:692
Expand Down
2 changes: 1 addition & 1 deletion library/operator.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@ msgid ""
"is equivalent to using the :class:`bool` constructor."
msgstr ""
"如果 *obj* 為真值則回傳 :const:`True`，否則回傳 :const:`False`。這等價於使"
"用 :class:`bool` 建構器。"
"用 :class:`bool` 建構函式。"

#: ../../library/operator.rst:75
msgid "Return ``a is b``. Tests object identity."
Expand Down
15 changes: 8 additions & 7 deletions library/plistlib.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,14 +42,14 @@ msgstr ""

#: ../../library/plistlib.rst:27
msgid ""
"To write out and to parse a plist file, use the :func:`dump` and :func:"
"`load` functions."
"To write out and to parse a plist file, use the :func:`dump` "
"and :func:`load` functions."
msgstr ""

#: ../../library/plistlib.rst:30
msgid ""
"To work with plist data in bytes or string objects, use :func:`dumps` and :"
"func:`loads`."
"To work with plist data in bytes or string objects, use :func:`dumps` "
"and :func:`loads`."
msgstr ""

#: ../../library/plistlib.rst:33
Expand Down Expand Up @@ -85,7 +85,7 @@ msgstr ""

#: ../../library/plistlib.rst:53
msgid "This module defines the following functions:"
msgstr ""
msgstr "此模組定義了以下函式："

#: ../../library/plistlib.rst:57
msgid ""
Expand Down Expand Up @@ -202,8 +202,9 @@ msgstr ""

#: ../../library/plistlib.rst:136
msgid ""
"Return *value* as a plist-formatted bytes object. See the documentation for :"
"func:`dump` for an explanation of the keyword arguments of this function."
"Return *value* as a plist-formatted bytes object. See the documentation "
"for :func:`dump` for an explanation of the keyword arguments of this "
"function."
msgstr ""

#: ../../library/plistlib.rst:143
Expand Down
Loading