Skip to content

Commit ec21d8a

Browse files
pydoc-zh-tw[bot]github-actions[bot]mattwang44
authored
Sync with CPython 3.12 (#490)
* sync with cpython 0c106a91 * sync with cpython c16cf9b6 * sync with cpython c1fd76e1 * sync with cpython 807afdac * sync with cpython d0176ed9 * sync with cpython 76fd98a6 * sync with cpython beb5e4fb * sync with cpython d87d67b9 * sync with cpython 84c5676e * fix: resolve fuzzy entries --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Matt Wang <mattwang44@gmail.com>
1 parent e31ddd1 commit ec21d8a

Some content is hidden

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

126 files changed

+5552
-5322
lines changed

‎c-api/arg.po

+4-4
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.12\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2023-07-17 17:39+0800\n"
10+
"POT-Creation-Date: 2023-07-24 00:03+0000\n"
1111
"PO-Revision-Date: 2022-10-16 03:21+0800\n"
1212
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -662,7 +662,7 @@ msgstr ""
662662
#: ../../c-api/arg.rst:345
663663
msgid ""
664664
"It is possible to pass \"long\" integers (integers whose value exceeds the "
665-
"platform's :const:`LONG_MAX`) however no proper range checking is done --- "
665+
"platform's :c:macro:`LONG_MAX`) however no proper range checking is done --- "
666666
"the most significant bits are silently truncated when the receiving field is "
667667
"too small to receive the value (actually, the semantics are inherited from "
668668
"downcasts in C --- your mileage may vary)."
@@ -807,7 +807,7 @@ msgstr ""
807807
msgid ""
808808
"A simpler form of parameter retrieval which does not use a format string to "
809809
"specify the types of the arguments. Functions which use this method to "
810-
"retrieve their parameters should be declared as :const:`METH_VARARGS` in "
810+
"retrieve their parameters should be declared as :c:macro:`METH_VARARGS` in "
811811
"function or method tables. The tuple containing the actual parameters "
812812
"should be passed as *args*; it must actually be a tuple. The length of the "
813813
"tuple must be at least *min* and no more than *max*; *min* and *max* may be "
@@ -943,7 +943,7 @@ msgstr "``u`` (:class:`str`) [const wchar_t \\*]"
943943

944944
#: ../../c-api/arg.rst:550
945945
msgid ""
946-
"Convert a null-terminated :c:expr:`wchar_t` buffer of Unicode (UTF-16 or "
946+
"Convert a null-terminated :c:type:`wchar_t` buffer of Unicode (UTF-16 or "
947947
"UCS-4) data to a Python Unicode object. If the Unicode buffer pointer is "
948948
"``NULL``, ``None`` is returned."
949949
msgstr ""

‎c-api/buffer.po

+4-4
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.12\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2023-05-09 00:15+0000\n"
10+
"POT-Creation-Date: 2023-07-24 00:03+0000\n"
1111
"PO-Revision-Date: 2018-05-23 14:30+0000\n"
1212
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -321,7 +321,7 @@ msgstr ""
321321

322322
#: ../../c-api/buffer.rst:228
323323
msgid ""
324-
"All :c:data:`Py_buffer` fields are unambiguously defined by the request type."
324+
"All :c:type:`Py_buffer` fields are unambiguously defined by the request type."
325325
msgstr ""
326326

327327
#: ../../c-api/buffer.rst:232
@@ -606,8 +606,8 @@ msgstr ""
606606

607607
#: ../../c-api/buffer.rst:467
608608
msgid ""
609-
"Return the implied :c:data:`~Py_buffer.itemsize` from :c:data:`~Py_buffer."
610-
"format`. On error, raise an exception and return -1."
609+
"Return the implied :c:member:`~Py_buffer.itemsize` from :c:member:"
610+
"`~Py_buffer.format`. On error, raise an exception and return -1."
611611
msgstr ""
612612

613613
#: ../../c-api/buffer.rst:475

‎c-api/call.po

+16-16
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python 3.12\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2023-07-17 17:39+0800\n"
11+
"POT-Creation-Date: 2023-07-22 00:04+0000\n"
1212
"PO-Revision-Date: 2022-10-16 03:20+0800\n"
1313
"Last-Translator: Matt Wang <mattwag44@gmail.com>\n"
1414
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -111,11 +111,11 @@ msgstr ""
111111

112112
#: ../../c-api/call.rst:62
113113
msgid ""
114-
"The :const:`Py_TPFLAGS_HAVE_VECTORCALL` flag is now removed from a class "
114+
"The :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag is now removed from a class "
115115
"when the class's :py:meth:`~object.__call__` method is reassigned. (This "
116116
"internally sets :c:member:`~PyTypeObject.tp_call` only, and thus may make it "
117117
"behave differently than the vectorcall function.) In earlier Python "
118-
"versions, vectorcall should only be used with :const:`immutable "
118+
"versions, vectorcall should only be used with :c:macro:`immutable "
119119
"<Py_TPFLAGS_IMMUTABLETYPE>` or static types."
120120
msgstr ""
121121

@@ -132,13 +132,13 @@ msgstr ""
132132

133133
#: ../../c-api/call.rst:74
134134
msgid ""
135-
"Classes can implement the vectorcall protocol by enabling the :const:"
135+
"Classes can implement the vectorcall protocol by enabling the :c:macro:"
136136
"`Py_TPFLAGS_HAVE_VECTORCALL` flag and setting :c:member:`~PyTypeObject."
137137
"tp_vectorcall_offset` to the offset inside the object structure where a "
138138
"*vectorcallfunc* appears. This is a pointer to a function with the following "
139139
"signature:"
140140
msgstr ""
141-
"類別可以透過啟用 :const:`Py_TPFLAGS_HAVE_VECTORCALL` 旗標並將 :c:member:"
141+
"類別可以透過啟用 :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` 旗標並將 :c:member:"
142142
"`~PyTypeObject.tp_vectorcall_offset` 設定為物件結構中有出現 *vectorcallfunc* "
143143
"的 offset 來實作 vectorcall 協定。這是一個指向具有以下簽章之函式的指標："
144144

@@ -163,10 +163,10 @@ msgstr "*nargsf* 是位置引數的數量加上可能會有的"
163163

164164
#: ../../c-api/call.rst:87
165165
msgid ""
166-
":const:`PY_VECTORCALL_ARGUMENTS_OFFSET` flag. To get the actual number of "
166+
":c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET` flag. To get the actual number of "
167167
"positional arguments from *nargsf*, use :c:func:`PyVectorcall_NARGS`."
168168
msgstr ""
169-
":const:`PY_VECTORCALL_ARGUMENTS_OFFSET` 旗標。如果要從 *nargsf* 獲得實際的位"
169+
":c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET` 旗標。如果要從 *nargsf* 獲得實際的位"
170170
"置引數數量，請使用 :c:func:`PyVectorcall_NARGS`。"
171171

172172
#: ../../c-api/call.rst:94
@@ -205,12 +205,12 @@ msgstr ""
205205
#: ../../c-api/call.rst:106
206206
msgid ""
207207
"Whenever they can do so cheaply (without additional allocation), callers are "
208-
"encouraged to use :const:`PY_VECTORCALL_ARGUMENTS_OFFSET`. Doing so will "
208+
"encouraged to use :c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET`. Doing so will "
209209
"allow callables such as bound methods to make their onward calls (which "
210210
"include a prepended *self* argument) very efficiently."
211211
msgstr ""
212212
"當可以以幾乎無代價的方式（無需佔據額外的記憶體）來達成，那麼會推薦呼叫者使"
213-
"用 :const:`PY_VECTORCALL_ARGUMENTS_OFFSET`。這樣做會讓如 bound method（繫結方"
213+
"用 :c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET`。這樣做會讓如 bound method（繫結方"
214214
"法）之類的可呼叫函式非常有效地繼續向前呼叫（這類函式包含一個在首位的 *self* "
215215
"引數）。"
216216

@@ -315,11 +315,11 @@ msgstr ""
315315
msgid ""
316316
"This is a specialized function, intended to be put in the :c:member:"
317317
"`~PyTypeObject.tp_call` slot or be used in an implementation of ``tp_call``. "
318-
"It does not check the :const:`Py_TPFLAGS_HAVE_VECTORCALL` flag and it does "
318+
"It does not check the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag and it does "
319319
"not fall back to ``tp_call``."
320320
msgstr ""
321321
"這是一個專門函式，其目的是被放入 :c:member:`~PyTypeObject.tp_call` 擴充槽或是"
322-
"用於 ``tp_call`` 的實作。它不會檢查 :const:`Py_TPFLAGS_HAVE_VECTORCALL` 旗標"
322+
"用於 ``tp_call`` 的實作。它不會檢查 :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` 旗標"
323323
"並且它不會退回 (fall back) 使用 ``tp_call``。"
324324

325325
#: ../../c-api/call.rst:186
@@ -654,24 +654,24 @@ msgid ""
654654
"method is given as a Python string *name*. The object whose method is called "
655655
"is *args[0]*, and the *args* array starting at *args[1]* represents the "
656656
"arguments of the call. There must be at least one positional argument. "
657-
"*nargsf* is the number of positional arguments including *args[0]*, plus :"
658-
"const:`PY_VECTORCALL_ARGUMENTS_OFFSET` if the value of ``args[0]`` may "
657+
"*nargsf* is the number of positional arguments including *args[0]*, plus :c:"
658+
"macro:`PY_VECTORCALL_ARGUMENTS_OFFSET` if the value of ``args[0]`` may "
659659
"temporarily be changed. Keyword arguments can be passed just like in :c:func:"
660660
"`PyObject_Vectorcall`."
661661
msgstr ""
662662
"使用 vectorcall 呼叫慣例來呼叫一個 method。method 的名稱以 Python 字串 "
663663
"*name* 的格式給定。被呼叫 method 的物件為 *args[0]*，而 *args* 陣列從 "
664664
"*args[1]* 開始的部分則代表呼叫的引數。必須傳入至少一個位置引數。*nargsf* 為包"
665665
"括 *args[0]* 在內的位置引數的數量，如果 ``args[0]`` 的值可能被臨時改變則要再"
666-
"加上 :const:`PY_VECTORCALL_ARGUMENTS_OFFSET`。關鍵字引數可以像在 :c:func:"
666+
"加上 :c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET`。關鍵字引數可以像在 :c:func:"
667667
"`PyObject_Vectorcall` 中一樣被傳入。"
668668

669669
#: ../../c-api/call.rst:399
670670
msgid ""
671-
"If the object has the :const:`Py_TPFLAGS_METHOD_DESCRIPTOR` feature, this "
671+
"If the object has the :c:macro:`Py_TPFLAGS_METHOD_DESCRIPTOR` feature, this "
672672
"will call the unbound method object with the full *args* vector as arguments."
673673
msgstr ""
674-
"如果物件具有 :const:`Py_TPFLAGS_METHOD_DESCRIPTOR` 特性，這將以完整的 *args* "
674+
"如果物件具有 :c:macro:`Py_TPFLAGS_METHOD_DESCRIPTOR` 特性，這將以完整的 *args* "
675675
"向量作為引數來呼叫 unbound method（未繫結方法）物件。"
676676

677677
#: ../../c-api/call.rst:410

‎c-api/complex.po

+3-3
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.12\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2023-06-30 15:31+0000\n"
10+
"POT-Creation-Date: 2023-07-22 00:04+0000\n"
1111
"PO-Revision-Date: 2015-12-09 17:51+0000\n"
1212
"Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -82,7 +82,7 @@ msgstr ""
8282
#: ../../c-api/complex.rst:66
8383
msgid ""
8484
"If *divisor* is null, this method returns zero and sets :c:data:`errno` to :"
85-
"c:data:`EDOM`."
85+
"c:macro:`EDOM`."
8686
msgstr ""
8787

8888
#: ../../c-api/complex.rst:72
@@ -94,7 +94,7 @@ msgstr ""
9494
#: ../../c-api/complex.rst:75
9595
msgid ""
9696
"If *num* is null and *exp* is not a positive real number, this method "
97-
"returns zero and sets :c:data:`errno` to :c:data:`EDOM`."
97+
"returns zero and sets :c:data:`errno` to :c:macro:`EDOM`."
9898
msgstr ""
9999

100100
#: ../../c-api/complex.rst:80

‎c-api/exceptions.po

+13-13
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python 3.12\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2023-07-17 17:39+0800\n"
11+
"POT-Creation-Date: 2023-07-24 00:03+0000\n"
1212
"PO-Revision-Date: 2018-05-23 14:05+0000\n"
1313
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1414
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -202,8 +202,8 @@ msgid ""
202202
"function has returned an error and set the C variable :c:data:`errno`. It "
203203
"constructs a tuple object whose first item is the integer :c:data:`errno` "
204204
"value and whose second item is the corresponding error message (gotten from :"
205-
"c:func:`strerror`), and then calls ``PyErr_SetObject(type, object)``. On "
206-
"Unix, when the :c:data:`errno` value is :const:`EINTR`, indicating an "
205+
"c:func:`!strerror`), and then calls ``PyErr_SetObject(type, object)``. On "
206+
"Unix, when the :c:data:`errno` value is :c:macro:`EINTR`, indicating an "
207207
"interrupted system call, this calls :c:func:`PyErr_CheckSignals`, and if "
208208
"that set the error indicator, leaves it set to that. The function always "
209209
"returns ``NULL``, so a wrapper function around a system call can write "
@@ -649,14 +649,14 @@ msgstr ""
649649

650650
#: ../../c-api/exceptions.rst:634
651651
msgid ""
652-
"The default Python signal handler for :const:`SIGINT` raises the :exc:"
652+
"The default Python signal handler for :c:macro:`SIGINT` raises the :exc:"
653653
"`KeyboardInterrupt` exception."
654654
msgstr ""
655655

656656
#: ../../c-api/exceptions.rst:645
657657
msgid ""
658-
"Simulate the effect of a :const:`SIGINT` signal arriving. This is equivalent "
659-
"to ``PyErr_SetInterruptEx(SIGINT)``."
658+
"Simulate the effect of a :c:macro:`SIGINT` signal arriving. This is "
659+
"equivalent to ``PyErr_SetInterruptEx(SIGINT)``."
660660
msgstr ""
661661

662662
#: ../../c-api/exceptions.rst:649 ../../c-api/exceptions.rst:676
@@ -682,8 +682,8 @@ msgstr ""
682682

683683
#: ../../c-api/exceptions.rst:668
684684
msgid ""
685-
"If the given signal isn't handled by Python (it was set to :data:`signal."
686-
"SIG_DFL` or :data:`signal.SIG_IGN`), it will be ignored."
685+
"If the given signal isn't handled by Python (it was set to :py:const:`signal."
686+
"SIG_DFL` or :py:const:`signal.SIG_IGN`), it will be ignored."
687687
msgstr ""
688688

689689
#: ../../c-api/exceptions.rst:671
@@ -776,7 +776,7 @@ msgstr ""
776776

777777
#: ../../c-api/exceptions.rst:757
778778
msgid ""
779-
"Return the cause (either an exception instance, or :const:`None`, set by "
779+
"Return the cause (either an exception instance, or ``None``, set by "
780780
"``raise ... from ...``) associated with the exception as a new reference, as "
781781
"accessible from Python through :attr:`__cause__`."
782782
msgstr ""
@@ -785,7 +785,7 @@ msgstr ""
785785
msgid ""
786786
"Set the cause associated with the exception to *cause*. Use ``NULL`` to "
787787
"clear it. There is no type check to make sure that *cause* is either an "
788-
"exception instance or :const:`None`. This steals a reference to *cause*."
788+
"exception instance or ``None``. This steals a reference to *cause*."
789789
msgstr ""
790790

791791
#: ../../c-api/exceptions.rst:768
@@ -894,9 +894,9 @@ msgstr ""
894894

895895
#: ../../c-api/exceptions.rst:877
896896
msgid ""
897-
"If :const:`USE_STACKCHECK` is defined, this function checks if the OS stack "
898-
"overflowed using :c:func:`PyOS_CheckStack`. In this is the case, it sets a :"
899-
"exc:`MemoryError` and returns a nonzero value."
897+
"If :c:macro:`USE_STACKCHECK` is defined, this function checks if the OS "
898+
"stack overflowed using :c:func:`PyOS_CheckStack`. In this is the case, it "
899+
"sets a :exc:`MemoryError` and returns a nonzero value."
900900
msgstr ""
901901

902902
#: ../../c-api/exceptions.rst:881

‎c-api/file.po

+5-5
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ msgid ""
99
msgstr ""
1010
"Project-Id-Version: Python 3.12\n"
1111
"Report-Msgid-Bugs-To: \n"
12-
"POT-Creation-Date: 2023-05-09 00:15+0000\n"
12+
"POT-Creation-Date: 2023-07-22 00:04+0000\n"
1313
"PO-Revision-Date: 2023-04-24 20:38+0800\n"
1414
"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
1515
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -162,11 +162,11 @@ msgstr ""
162162
#: ../../c-api/file.rst:95
163163
msgid ""
164164
"Write object *obj* to file object *p*. The only supported flag for *flags* "
165-
"is :const:`Py_PRINT_RAW`; if given, the :func:`str` of the object is written "
166-
"instead of the :func:`repr`. Return ``0`` on success or ``-1`` on failure; "
167-
"the appropriate exception will be set."
165+
"is :c:macro:`Py_PRINT_RAW`; if given, the :func:`str` of the object is "
166+
"written instead of the :func:`repr`. Return ``0`` on success or ``-1`` on "
167+
"failure; the appropriate exception will be set."
168168
msgstr ""
169-
"將物件 *obj* 寫入檔案物件 *p*。 *flags* 唯一支援的旗標是 :const:"
169+
"將物件 *obj* 寫入檔案物件 *p*。 *flags* 唯一支援的旗標是 :c:macro:"
170170
"`Py_PRINT_RAW`；如果有給定，則寫入物件的 :func:`str` 而不是 :func:`repr`。在"
171171
"成功回傳 ``0`` 或在失敗回傳 ``-1``；將設定適當的例外。"
172172

‎c-api/float.po

+7-7
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ msgid ""
99
msgstr ""
1010
"Project-Id-Version: Python 3.12\n"
1111
"Report-Msgid-Bugs-To: \n"
12-
"POT-Creation-Date: 2023-06-30 15:31+0000\n"
12+
"POT-Creation-Date: 2023-07-22 00:04+0000\n"
1313
"PO-Revision-Date: 2017-09-22 18:26+0000\n"
1414
"Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
1515
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -138,9 +138,9 @@ msgid ""
138138
"The pack routines write 2, 4 or 8 bytes, starting at *p*. *le* is an :c:expr:"
139139
"`int` argument, non-zero if you want the bytes string in little-endian "
140140
"format (exponent last, at ``p+1``, ``p+3``, or ``p+6`` ``p+7``), zero if you "
141-
"want big-endian format (exponent first, at *p*). The :c:data:`PY_BIG_ENDIAN` "
142-
"constant can be used to use the native endian: it is equal to ``1`` on big "
143-
"endian processor, or ``0`` on little endian processor."
141+
"want big-endian format (exponent first, at *p*). The :c:macro:"
142+
"`PY_BIG_ENDIAN` constant can be used to use the native endian: it is equal "
143+
"to ``1`` on big endian processor, or ``0`` on little endian processor."
144144
msgstr ""
145145

146146
#: ../../c-api/float.rst:116
@@ -182,9 +182,9 @@ msgid ""
182182
"The unpack routines read 2, 4 or 8 bytes, starting at *p*. *le* is an :c:"
183183
"expr:`int` argument, non-zero if the bytes string is in little-endian format "
184184
"(exponent last, at ``p+1``, ``p+3`` or ``p+6`` and ``p+7``), zero if big-"
185-
"endian (exponent first, at *p*). The :c:data:`PY_BIG_ENDIAN` constant can be "
186-
"used to use the native endian: it is equal to ``1`` on big endian processor, "
187-
"or ``0`` on little endian processor."
185+
"endian (exponent first, at *p*). The :c:macro:`PY_BIG_ENDIAN` constant can "
186+
"be used to use the native endian: it is equal to ``1`` on big endian "
187+
"processor, or ``0`` on little endian processor."
188188
msgstr ""
189189

190190
#: ../../c-api/float.rst:147

0 commit comments

Comments
 (0)