Skip to content

Commit b7744e5

Browse files
pydoc-zh-tw[bot]github-actions[bot]mattwang44
authored
Sync with CPython 3.14 (#1153)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Matt.Wang <mattwang44@gmail.com>
1 parent 7893e44 commit b7744e5

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

82 files changed

+5857
-5306
lines changed

c-api/capsule.po

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ msgid ""
66
msgstr ""
77
"Project-Id-Version: Python 3.14\n"
88
"Report-Msgid-Bugs-To: \n"
9-
"POT-Creation-Date: 2025-06-29 00:17+0000\n"
9+
"POT-Creation-Date: 2025-10-25 22:20+0000\n"
1010
"PO-Revision-Date: 2018-05-23 14:30+0000\n"
1111
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1212
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -29,7 +29,7 @@ msgstr ""
2929
#: ../../c-api/capsule.rst:17
3030
msgid ""
3131
"This subtype of :c:type:`PyObject` represents an opaque value, useful for C "
32-
"extension modules who need to pass an opaque value (as a :c:expr:`void*` "
32+
"extension modules which need to pass an opaque value (as a :c:expr:`void*` "
3333
"pointer) through Python code to other C code. It is often used to make a C "
3434
"function pointer defined in one module available to other modules, so the "
3535
"regular import mechanism can be used to access C APIs defined in dynamically "

c-api/cell.po

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ msgid ""
1010
msgstr ""
1111
"Project-Id-Version: Python 3.14\n"
1212
"Report-Msgid-Bugs-To: \n"
13-
"POT-Creation-Date: 2024-07-10 00:04+0000\n"
13+
"POT-Creation-Date: 2025-11-05 00:16+0000\n"
1414
"PO-Revision-Date: 2022-10-16 15:33+0800\n"
1515
"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
1616
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -30,7 +30,7 @@ msgstr "Cell 物件"
3030
msgid ""
3131
"\"Cell\" objects are used to implement variables referenced by multiple "
3232
"scopes. For each such variable, a cell object is created to store the value; "
33-
"the local variables of each stack frame that references the value contains a "
33+
"the local variables of each stack frame that references the value contain a "
3434
"reference to the cells from outer scopes which also use that variable. When "
3535
"the value is accessed, the value contained in the cell is used instead of "
3636
"the cell object itself. This de-referencing of the cell object requires "

c-api/code.po

Lines changed: 26 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ msgid ""
66
msgstr ""
77
"Project-Id-Version: Python 3.14\n"
88
"Report-Msgid-Bugs-To: \n"
9-
"POT-Creation-Date: 2025-09-08 15:25+0800\n"
9+
"POT-Creation-Date: 2025-10-25 22:20+0000\n"
1010
"PO-Revision-Date: 2015-12-09 17:51+0000\n"
1111
"Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
1212
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -36,8 +36,8 @@ msgstr ""
3636

3737
#: ../../c-api/code.rst:24
3838
msgid ""
39-
"This is an instance of :c:type:`PyTypeObject` representing the "
40-
"Python :ref:`code object <code-objects>`."
39+
"This is an instance of :c:type:`PyTypeObject` representing the Python :ref:"
40+
"`code object <code-objects>`."
4141
msgstr ""
4242

4343
#: ../../c-api/code.rst:30
@@ -73,9 +73,8 @@ msgstr ""
7373

7474
#: ../../c-api/code.rst:54
7575
msgid ""
76-
"Since the definition of the bytecode changes often, "
77-
"calling :c:func:`PyUnstable_Code_New` directly can bind you to a precise "
78-
"Python version."
76+
"Since the definition of the bytecode changes often, calling :c:func:"
77+
"`PyUnstable_Code_New` directly can bind you to a precise Python version."
7978
msgstr ""
8079

8180
#: ../../c-api/code.rst:57
@@ -132,9 +131,8 @@ msgstr ""
132131

133132
#: ../../c-api/code.rst:101
134133
msgid ""
135-
"For efficiently iterating over the line numbers in a code object, "
136-
"use :pep:`the API described in PEP 626 <0626#out-of-process-debuggers-and-"
137-
"profilers>`."
134+
"For efficiently iterating over the line numbers in a code object, use :pep:"
135+
"`the API described in PEP 626 <0626#out-of-process-debuggers-and-profilers>`."
138136
msgstr ""
139137

140138
#: ../../c-api/code.rst:106
@@ -180,9 +178,9 @@ msgstr ""
180178
#: ../../c-api/code.rst:147
181179
msgid ""
182180
"Equivalent to the Python code ``getattr(co, 'co_freevars')``. Returns a new "
183-
"reference to a :c:type:`PyTupleObject` containing the names of "
184-
"the :term:`free (closure) variables <closure variable>`. On error, ``NULL`` "
185-
"is returned and an exception is raised."
181+
"reference to a :c:type:`PyTupleObject` containing the names of the :term:"
182+
"`free (closure) variables <closure variable>`. On error, ``NULL`` is "
183+
"returned and an exception is raised."
186184
msgstr ""
187185

188186
#: ../../c-api/code.rst:156
@@ -195,10 +193,10 @@ msgstr ""
195193

196194
#: ../../c-api/code.rst:165
197195
msgid ""
198-
"Clear watcher identified by *watcher_id* previously returned "
199-
"from :c:func:`PyCode_AddWatcher` for the current interpreter. Return ``0`` "
200-
"on success, or ``-1`` and set an exception on error (e.g. if the given "
201-
"*watcher_id* was never registered.)"
196+
"Clear watcher identified by *watcher_id* previously returned from :c:func:"
197+
"`PyCode_AddWatcher` for the current interpreter. Return ``0`` on success, or "
198+
"``-1`` and set an exception on error (e.g. if the given *watcher_id* was "
199+
"never registered.)"
202200
msgstr ""
203201

204202
#: ../../c-api/code.rst:174
@@ -240,8 +238,8 @@ msgstr ""
240238
#: ../../c-api/code.rst:201
241239
msgid ""
242240
"If the callback sets an exception, it must return ``-1``; this exception "
243-
"will be printed as an unraisable exception "
244-
"using :c:func:`PyErr_WriteUnraisable`. Otherwise it should return ``0``."
241+
"will be printed as an unraisable exception using :c:func:"
242+
"`PyErr_WriteUnraisable`. Otherwise it should return ``0``."
245243
msgstr ""
246244

247245
#: ../../c-api/code.rst:205
@@ -259,18 +257,18 @@ msgstr "程式碼物件旗標"
259257

260258
#: ../../c-api/code.rst:219
261259
msgid ""
262-
"Code objects contain a bit-field of flags, which can be retrieved as "
263-
"the :attr:`~codeobject.co_flags` Python attribute (for example "
264-
"using :c:func:`PyObject_GetAttrString`), and set using a *flags* argument "
265-
"to :c:func:`PyUnstable_Code_New` and similar functions."
260+
"Code objects contain a bit-field of flags, which can be retrieved as the :"
261+
"attr:`~codeobject.co_flags` Python attribute (for example using :c:func:"
262+
"`PyObject_GetAttrString`), and set using a *flags* argument to :c:func:"
263+
"`PyUnstable_Code_New` and similar functions."
266264
msgstr ""
267265

268266
#: ../../c-api/code.rst:224
269267
msgid ""
270268
"Flags whose names start with ``CO_FUTURE_`` correspond to features normally "
271-
"selectable by :ref:`future statements <future>`. These flags can be used "
272-
"in :c:member:`PyCompilerFlags.cf_flags`. Note that many ``CO_FUTURE_`` flags "
273-
"are mandatory in current versions of Python, and setting them has no effect."
269+
"selectable by :ref:`future statements <future>`. These flags can be used in :"
270+
"c:member:`PyCompilerFlags.cf_flags`. Note that many ``CO_FUTURE_`` flags are "
271+
"mandatory in current versions of Python, and setting them has no effect."
274272
msgstr ""
275273

276274
#: ../../c-api/code.rst:230
@@ -378,7 +376,7 @@ msgid ""
378376
msgstr ""
379377

380378
#: ../../c-api/code.rst:292
381-
msgid "Return a new an opaque index value used to adding data to code objects."
379+
msgid "Return a new opaque index value used to adding data to code objects."
382380
msgstr ""
383381

384382
#: ../../c-api/code.rst:294
@@ -391,8 +389,8 @@ msgstr ""
391389
#: ../../c-api/code.rst:298
392390
msgid ""
393391
"If *free* is not ``NULL``: when a code object is deallocated, *free* will be "
394-
"called on non-``NULL`` data stored under the new index. "
395-
"Use :c:func:`Py_DecRef` when storing :c:type:`PyObject`."
392+
"called on non-``NULL`` data stored under the new index. Use :c:func:"
393+
"`Py_DecRef` when storing :c:type:`PyObject`."
396394
msgstr ""
397395

398396
#: ../../c-api/code.rst:304

c-api/codec.po

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.14\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2023-07-29 00:03+0000\n"
10+
"POT-Creation-Date: 2025-11-07 00:14+0000\n"
1111
"PO-Revision-Date: 2023-07-24 17:51+0000\n"
1212
"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -28,8 +28,9 @@ msgstr "註冊一個新的編解碼器搜尋函式。"
2828

2929
#: ../../c-api/codec.rst:10
3030
msgid ""
31-
"As side effect, this tries to load the :mod:`!encodings` package, if not yet "
32-
"done, to make sure that it is always first in the list of search functions."
31+
"As a side effect, this tries to load the :mod:`!encodings` package, if not "
32+
"yet done, to make sure that it is always first in the list of search "
33+
"functions."
3334
msgstr ""
3435
"作為副作用 (side effect),這會嘗試載入 :mod:`!encodings`\\ (如果尚未完成),"
3536
"以確保它始終位於搜尋函式列表中的第一個。"
@@ -75,11 +76,11 @@ msgid ""
7576
"*object* is passed through the decoder function found for the given "
7677
"*encoding* using the error handling method defined by *errors*. *errors* "
7778
"may be ``NULL`` to use the default method defined for the codec. Raises a :"
78-
"exc:`LookupError` if no encoder can be found."
79+
"exc:`LookupError` if no decoder can be found."
7980
msgstr ""
8081
"*object* 被傳遞給以給定 *encoding* 所查找到的解碼器函式,並使用以 *errors* 定"
8182
"義的錯誤處理方法。*errors* 可以設為 ``NULL`` 來使用編解碼器定義的預設方法。如"
82-
"果找不到編碼器,則引發 :exc:`LookupError`。"
83+
"果找不到解碼器,則引發 :exc:`LookupError`。"
8384

8485
#: ../../c-api/codec.rst:46
8586
msgid "Codec lookup API"
@@ -198,3 +199,13 @@ msgstr "將 unicode 編碼錯誤替換為反斜線跳脫(``\\x``、``\\u`` 和
198199
#: ../../c-api/codec.rst:129
199200
msgid "Replace the unicode encode error with ``\\N{...}`` escapes."
200201
msgstr "將 unicode 編碼錯誤替換為 ``\\N{...}`` 跳脫。"
202+
203+
#: ../../c-api/codec.rst:135
204+
msgid "Codec utility variables"
205+
msgstr ""
206+
207+
#: ../../c-api/codec.rst:139
208+
msgid ""
209+
"A string constant containing the lowercase hexadecimal digits: "
210+
"``\"0123456789abcdef\"``."
211+
msgstr ""

c-api/conversion.po

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ msgid ""
99
msgstr ""
1010
"Project-Id-Version: Python 3.14\n"
1111
"Report-Msgid-Bugs-To: \n"
12-
"POT-Creation-Date: 2025-09-08 15:25+0800\n"
12+
"POT-Creation-Date: 2025-11-03 00:16+0000\n"
1313
"PO-Revision-Date: 2023-12-11 18:26+0000\n"
1414
"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
1515
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -31,17 +31,17 @@ msgstr "用於數字轉換和格式化字串輸出的函式。"
3131
#: ../../c-api/conversion.rst:13
3232
msgid ""
3333
"Output not more than *size* bytes to *str* according to the format string "
34-
"*format* and the extra arguments. See the Unix man "
35-
"page :manpage:`snprintf(3)`."
34+
"*format* and the extra arguments. See the Unix man page :manpage:"
35+
"`snprintf(3)`."
3636
msgstr ""
3737
"根據格式字串 *format* 和額外引數,輸出不超過 *size* 位元組給 *str*。請參閱 "
3838
"Unix 使用手冊 :manpage:`snprintf(3)`。"
3939

4040
#: ../../c-api/conversion.rst:19
4141
msgid ""
4242
"Output not more than *size* bytes to *str* according to the format string "
43-
"*format* and the variable argument list *va*. Unix man "
44-
"page :manpage:`vsnprintf(3)`."
43+
"*format* and the variable argument list *va*. Unix man page :manpage:"
44+
"`vsnprintf(3)`."
4545
msgstr ""
4646
"根據格式字串 *format* 和變數引數串列 *va*,輸出不超過 *size* 位元組給 *str*。"
4747
"Unix 使用手冊 :manpage:`vsnprintf(3)`。"
@@ -53,9 +53,9 @@ msgid ""
5353
"is to guarantee consistent behavior in corner cases, which the Standard C "
5454
"functions do not."
5555
msgstr ""
56-
":c:func:`PyOS_snprintf` 和 :c:func:`PyOS_vsnprintf` 包裝標準 C 函式庫函"
57-
"式 :c:func:`snprintf` 和 :c:func:`vsnprintf`。它們的目的是確保邊角案例 "
58-
"(corner case) 下的行為一致,而標準 C 函式則不然。"
56+
":c:func:`PyOS_snprintf` 和 :c:func:`PyOS_vsnprintf` 包裝標準 C 函式庫函式 :c:"
57+
"func:`snprintf` 和 :c:func:`vsnprintf`。它們的目的是確保邊角案例 (corner "
58+
"case) 下的行為一致,而標準 C 函式則不然。"
5959

6060
#: ../../c-api/conversion.rst:28
6161
msgid ""
@@ -97,11 +97,11 @@ msgstr ""
9797

9898
#: ../../c-api/conversion.rst:44
9999
msgid ""
100-
"When ``rv < 0``, \"something bad happened.\" ``str[size-1]`` is ``'\\0'`` in "
101-
"this case too, but the rest of *str* is undefined. The exact cause of the "
102-
"error depends on the underlying platform."
100+
"When ``rv < 0``, the output conversion failed and ``str[size-1]`` is "
101+
"``'\\0'`` in this case too, but the rest of *str* is undefined. The exact "
102+
"cause of the error depends on the underlying platform."
103103
msgstr ""
104-
"當 ``rv < 0`` 時,代表「有不好的事情發生了」。在這種情況下,``str[size-1]`` "
104+
"當 ``rv < 0`` 時,代表輸出的轉換失敗,且在這種情況下 ``str[size-1]`` "
105105
"也是 ``'\\0'``,但 *str* 的其餘部分未定義。錯誤的確切原因取決於底層平台。"
106106

107107
#: ../../c-api/conversion.rst:49
@@ -129,9 +129,9 @@ msgstr ""
129129
#: ../../c-api/conversion.rst:63
130130
msgid ""
131131
"If the converted value falls out of range of corresponding return type, "
132-
"range error occurs (:c:data:`errno` is set to :c:macro:`!ERANGE`) "
133-
"and :c:macro:`!ULONG_MAX` is returned. If no conversion can be performed, "
134-
"``0`` is returned."
132+
"range error occurs (:c:data:`errno` is set to :c:macro:`!ERANGE`) and :c:"
133+
"macro:`!ULONG_MAX` is returned. If no conversion can be performed, ``0`` is "
134+
"returned."
135135
msgstr ""
136136

137137
#: ../../c-api/conversion.rst:68
@@ -169,9 +169,9 @@ msgstr ""
169169

170170
#: ../../c-api/conversion.rst:95
171171
msgid ""
172-
"If ``endptr`` is ``NULL``, convert the whole string. "
173-
"Raise :exc:`ValueError` and return ``-1.0`` if the string is not a valid "
174-
"representation of a floating-point number."
172+
"If ``endptr`` is ``NULL``, convert the whole string. Raise :exc:"
173+
"`ValueError` and return ``-1.0`` if the string is not a valid representation "
174+
"of a floating-point number."
175175
msgstr ""
176176
"如果 ``endptr`` 為 ``NULL``,則轉換整個字串。如果字串不是浮點數的有效表示,則"
177177
"引發 :exc:`ValueError` 並回傳 ``-1.0``。"

c-api/datetime.po

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ msgid ""
1010
msgstr ""
1111
"Project-Id-Version: Python 3.14\n"
1212
"Report-Msgid-Bugs-To: \n"
13-
"POT-Creation-Date: 2023-08-22 00:03+0000\n"
13+
"POT-Creation-Date: 2025-11-05 00:16+0000\n"
1414
"PO-Revision-Date: 2025-10-14 20:39+0800\n"
1515
"Last-Translator: Yorkxe <karta25768@gmail.com>\n"
1616
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -86,7 +86,7 @@ msgstr ""
8686

8787
#: ../../c-api/datetime.rst:49
8888
msgid ""
89-
"This instance of :c:type:`PyTypeObject` represents Python type for the "
89+
"This instance of :c:type:`PyTypeObject` represents the Python type for the "
9090
"difference between two datetime values; it is the same object as :class:"
9191
"`datetime.timedelta` in the Python layer."
9292
msgstr ""

c-api/descriptor.po

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ msgid ""
99
msgstr ""
1010
"Project-Id-Version: Python 3.14\n"
1111
"Report-Msgid-Bugs-To: \n"
12-
"POT-Creation-Date: 2021-10-26 16:47+0000\n"
12+
"POT-Creation-Date: 2025-11-05 00:16+0000\n"
1313
"PO-Revision-Date: 2021-12-09 20:56+0800\n"
1414
"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
1515
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -39,9 +39,9 @@ msgstr "內建 descriptor 型別的型別物件。"
3939

4040
#: ../../c-api/descriptor.rst:35
4141
msgid ""
42-
"Return non-zero if the descriptor objects *descr* describes a data "
43-
"attribute, or ``0`` if it describes a method. *descr* must be a descriptor "
44-
"object; there is no error checking."
42+
"Return non-zero if the descriptor object *descr* describes a data attribute, "
43+
"or ``0`` if it describes a method. *descr* must be a descriptor object; "
44+
"there is no error checking."
4545
msgstr ""
4646
"如果 descriptor 物件 *descr* 描述的是一個資料屬性則回傳非零值,或者如果它描述"
47-
"的是一個方法則返回 ``0``。*descr* 必須為一個 descriptor 物件;沒有錯誤檢查。"
47+
"的是一個方法則回傳 ``0``。*descr* 必須為一個 descriptor 物件;沒有錯誤檢查。"

0 commit comments

Comments
 (0)