Skip to content

Commit 4d377d4

Browse files
pydoc-zh-tw[bot]github-actions[bot]mattwang44
authored
Sync with CPython 3.11 (#424)
* sync with cpython 05d06e58 * sync with cpython dbe416b8 * sync with cpython 1bbf60dc * sync with cpython 97cf0291 * sync with cpython fbb0151e * sync with cpython 2cce4654 * sync with cpython ce091c96 * sync with cpython f5e29f42 * 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 d393cdb commit 4d377d4

18 files changed

+2140
-1998
lines changed

‎c-api/complex.po

+9-9
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.11\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2023-05-09 00:15+0000\n"
10+
"POT-Creation-Date: 2023-06-30 15:31+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-"
@@ -148,17 +148,17 @@ msgstr ""
148148

149149
#: ../../c-api/complex.rst:130
150150
msgid ""
151-
"If *op* is not a Python complex number object but has a :meth:`__complex__` "
152-
"method, this method will first be called to convert *op* to a Python complex "
153-
"number object. If ``__complex__()`` is not defined then it falls back to :"
154-
"meth:`__float__`. If ``__float__()`` is not defined then it falls back to :"
155-
"meth:`__index__`. Upon failure, this method returns ``-1.0`` as a real "
156-
"value."
151+
"If *op* is not a Python complex number object but has a :meth:`~object."
152+
"__complex__` method, this method will first be called to convert *op* to a "
153+
"Python complex number object. If :meth:`!__complex__` is not defined then "
154+
"it falls back to :meth:`~object.__float__`. If :meth:`!__float__` is not "
155+
"defined then it falls back to :meth:`~object.__index__`. Upon failure, this "
156+
"method returns ``-1.0`` as a real value."
157157
msgstr ""
158158

159159
#: ../../c-api/complex.rst:137
160-
msgid "Use :meth:`__index__` if available."
161-
msgstr "如果可用則會使用 :meth:`__index__`。"
160+
msgid "Use :meth:`~object.__index__` if available."
161+
msgstr "如果可用則使用 :meth:`~object.__index__`。"
162162

163163
#: ../../c-api/complex.rst:8
164164
msgid "object"

‎c-api/dict.po

+26-25
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ msgid ""
99
msgstr ""
1010
"Project-Id-Version: Python 3.11\n"
1111
"Report-Msgid-Bugs-To: \n"
12-
"POT-Creation-Date: 2023-05-09 00:15+0000\n"
12+
"POT-Creation-Date: 2023-06-25 00:20+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-"
@@ -117,40 +117,41 @@ msgid ""
117117
"``NULL`` if the key *key* is not present, but *without* setting an exception."
118118
msgstr ""
119119

120-
#: ../../c-api/dict.rst:101
120+
#: ../../c-api/dict.rst:103
121121
msgid ""
122-
"Note that exceptions which occur while calling :meth:`__hash__` and :meth:"
123-
"`__eq__` methods will get suppressed. To get error reporting use :c:func:"
124-
"`PyDict_GetItemWithError()` instead."
122+
"Exceptions that occur while this calls :meth:`~object.__hash__` and :meth:"
123+
"`~object.__eq__` methods are silently ignored. Prefer the :c:func:"
124+
"`PyDict_GetItemWithError` function instead."
125125
msgstr ""
126126

127-
#: ../../c-api/dict.rst:105
127+
#: ../../c-api/dict.rst:107
128128
msgid ""
129129
"Calling this API without :term:`GIL` held had been allowed for historical "
130130
"reason. It is no longer allowed."
131131
msgstr ""
132132

133-
#: ../../c-api/dict.rst:112
133+
#: ../../c-api/dict.rst:114
134134
msgid ""
135135
"Variant of :c:func:`PyDict_GetItem` that does not suppress exceptions. "
136136
"Return ``NULL`` **with** an exception set if an exception occurred. Return "
137137
"``NULL`` **without** an exception set if the key wasn't present."
138138
msgstr ""
139139

140-
#: ../../c-api/dict.rst:120
140+
#: ../../c-api/dict.rst:122
141141
msgid ""
142142
"This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a :c:"
143143
"expr:`const char*`, rather than a :c:expr:`PyObject*`."
144144
msgstr ""
145145

146-
#: ../../c-api/dict.rst:123
146+
#: ../../c-api/dict.rst:127
147147
msgid ""
148-
"Note that exceptions which occur while calling :meth:`__hash__` and :meth:"
149-
"`__eq__` methods and creating a temporary string object will get suppressed. "
150-
"To get error reporting use :c:func:`PyDict_GetItemWithError()` instead."
148+
"Exceptions that occur while this calls :meth:`~object.__hash__` and :meth:"
149+
"`~object.__eq__` methods or while creating the temporary :class:`str` object "
150+
"are silently ignored. Prefer using the :c:func:`PyDict_GetItemWithError` "
151+
"function with your own :c:func:`PyUnicode_FromString` *key* instead."
151152
msgstr ""
152153

153-
#: ../../c-api/dict.rst:131
154+
#: ../../c-api/dict.rst:136
154155
msgid ""
155156
"This is the same as the Python-level :meth:`dict.setdefault`. If present, "
156157
"it returns the value corresponding to *key* from the dictionary *p*. If the "
@@ -160,29 +161,29 @@ msgid ""
160161
"the insertion."
161162
msgstr ""
162163

163-
#: ../../c-api/dict.rst:141
164+
#: ../../c-api/dict.rst:146
164165
msgid ""
165166
"Return a :c:type:`PyListObject` containing all the items from the dictionary."
166167
msgstr ""
167168

168-
#: ../../c-api/dict.rst:146
169+
#: ../../c-api/dict.rst:151
169170
msgid ""
170171
"Return a :c:type:`PyListObject` containing all the keys from the dictionary."
171172
msgstr ""
172173

173-
#: ../../c-api/dict.rst:151
174+
#: ../../c-api/dict.rst:156
174175
msgid ""
175176
"Return a :c:type:`PyListObject` containing all the values from the "
176177
"dictionary *p*."
177178
msgstr ""
178179

179-
#: ../../c-api/dict.rst:159
180+
#: ../../c-api/dict.rst:164
180181
msgid ""
181182
"Return the number of items in the dictionary. This is equivalent to "
182183
"``len(p)`` on a dictionary."
183184
msgstr ""
184185

185-
#: ../../c-api/dict.rst:165
186+
#: ../../c-api/dict.rst:170
186187
msgid ""
187188
"Iterate over all key-value pairs in the dictionary *p*. The :c:type:"
188189
"`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` prior to the "
@@ -196,21 +197,21 @@ msgid ""
196197
"structure is sparse, the offsets are not consecutive."
197198
msgstr ""
198199

199-
#: ../../c-api/dict.rst:176
200+
#: ../../c-api/dict.rst:181
200201
msgid "For example::"
201202
msgstr ""
202203
"舉例來說：\n"
203204
"\n"
204205
"::"
205206

206-
#: ../../c-api/dict.rst:186
207+
#: ../../c-api/dict.rst:191
207208
msgid ""
208209
"The dictionary *p* should not be mutated during iteration. It is safe to "
209210
"modify the values of the keys as you iterate over the dictionary, but only "
210211
"so long as the set of keys does not change. For example::"
211212
msgstr ""
212213

213-
#: ../../c-api/dict.rst:211
214+
#: ../../c-api/dict.rst:216
214215
msgid ""
215216
"Iterate over mapping object *b* adding key-value pairs to dictionary *a*. "
216217
"*b* may be a dictionary, or any object supporting :c:func:`PyMapping_Keys` "
@@ -220,7 +221,7 @@ msgid ""
220221
"or ``-1`` if an exception was raised."
221222
msgstr ""
222223

223-
#: ../../c-api/dict.rst:221
224+
#: ../../c-api/dict.rst:226
224225
msgid ""
225226
"This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to ``a."
226227
"update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall back "
@@ -229,7 +230,7 @@ msgid ""
229230
"exception was raised."
230231
msgstr ""
231232

232-
#: ../../c-api/dict.rst:230
233+
#: ../../c-api/dict.rst:235
233234
msgid ""
234235
"Update or merge into dictionary *a*, from the key-value pairs in *seq2*. "
235236
"*seq2* must be an iterable object producing iterable objects of length 2, "
@@ -250,10 +251,10 @@ msgstr "dictionary（字典）"
250251
msgid "PyUnicode_FromString()"
251252
msgstr "PyUnicode_FromString()"
252253

253-
#: ../../c-api/dict.rst:157
254+
#: ../../c-api/dict.rst:162
254255
msgid "built-in function"
255256
msgstr "built-in function（內建函式）"
256257

257-
#: ../../c-api/dict.rst:157
258+
#: ../../c-api/dict.rst:162
258259
msgid "len"
259260
msgstr "len"

‎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.11\n"
1111
"Report-Msgid-Bugs-To: \n"
12-
"POT-Creation-Date: 2023-05-09 00:15+0000\n"
12+
"POT-Creation-Date: 2023-06-30 15:31+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-"
@@ -61,15 +61,15 @@ msgstr ""
6161
#: ../../c-api/float.rst:47
6262
msgid ""
6363
"Return a C :c:expr:`double` representation of the contents of *pyfloat*. If "
64-
"*pyfloat* is not a Python floating point object but has a :meth:`__float__` "
65-
"method, this method will first be called to convert *pyfloat* into a float. "
66-
"If ``__float__()`` is not defined then it falls back to :meth:`__index__`. "
67-
"This method returns ``-1.0`` upon failure, so one should call :c:func:"
68-
"`PyErr_Occurred` to check for errors."
64+
"*pyfloat* is not a Python floating point object but has a :meth:`~object."
65+
"__float__` method, this method will first be called to convert *pyfloat* "
66+
"into a float. If :meth:`!__float__` is not defined then it falls back to :"
67+
"meth:`~object.__index__`. This method returns ``-1.0`` upon failure, so one "
68+
"should call :c:func:`PyErr_Occurred` to check for errors."
6969
msgstr ""
7070

7171
#: ../../c-api/float.rst:54
72-
msgid "Use :meth:`__index__` if available."
72+
msgid "Use :meth:`~object.__index__` if available."
7373
msgstr ""
7474

7575
#: ../../c-api/float.rst:60

‎c-api/long.po

+11-11
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python 3.11\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2023-05-09 00:15+0000\n"
11+
"POT-Creation-Date: 2023-06-30 15:31+0000\n"
1212
"PO-Revision-Date: 2018-05-23 14:06+0000\n"
1313
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1414
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -140,8 +140,8 @@ msgstr ""
140140
#: ../../c-api/long.rst:122 ../../c-api/long.rst:140
141141
msgid ""
142142
"Return a C :c:expr:`long` representation of *obj*. If *obj* is not an "
143-
"instance of :c:type:`PyLongObject`, first call its :meth:`__index__` method "
144-
"(if present) to convert it to a :c:type:`PyLongObject`."
143+
"instance of :c:type:`PyLongObject`, first call its :meth:`~object.__index__` "
144+
"method (if present) to convert it to a :c:type:`PyLongObject`."
145145
msgstr ""
146146

147147
#: ../../c-api/long.rst:126
@@ -157,12 +157,12 @@ msgstr ""
157157

158158
#: ../../c-api/long.rst:131 ../../c-api/long.rst:151 ../../c-api/long.rst:172
159159
#: ../../c-api/long.rst:194 ../../c-api/long.rst:278 ../../c-api/long.rst:298
160-
msgid "Use :meth:`__index__` if available."
160+
msgid "Use :meth:`~object.__index__` if available."
161161
msgstr ""
162162

163163
#: ../../c-api/long.rst:134 ../../c-api/long.rst:154 ../../c-api/long.rst:175
164164
#: ../../c-api/long.rst:197 ../../c-api/long.rst:281 ../../c-api/long.rst:301
165-
msgid "This function will no longer use :meth:`__int__`."
165+
msgid "This function will no longer use :meth:`~object.__int__`."
166166
msgstr ""
167167

168168
#: ../../c-api/long.rst:144
@@ -176,8 +176,8 @@ msgstr ""
176176
#: ../../c-api/long.rst:163 ../../c-api/long.rst:181
177177
msgid ""
178178
"Return a C :c:expr:`long long` representation of *obj*. If *obj* is not an "
179-
"instance of :c:type:`PyLongObject`, first call its :meth:`__index__` method "
180-
"(if present) to convert it to a :c:type:`PyLongObject`."
179+
"instance of :c:type:`PyLongObject`, first call its :meth:`~object.__index__` "
180+
"method (if present) to convert it to a :c:type:`PyLongObject`."
181181
msgstr ""
182182

183183
#: ../../c-api/long.rst:167
@@ -268,8 +268,8 @@ msgstr ""
268268
#: ../../c-api/long.rst:268
269269
msgid ""
270270
"Return a C :c:expr:`unsigned long` representation of *obj*. If *obj* is not "
271-
"an instance of :c:type:`PyLongObject`, first call its :meth:`__index__` "
272-
"method (if present) to convert it to a :c:type:`PyLongObject`."
271+
"an instance of :c:type:`PyLongObject`, first call its :meth:`~object."
272+
"__index__` method (if present) to convert it to a :c:type:`PyLongObject`."
273273
msgstr ""
274274

275275
#: ../../c-api/long.rst:272
@@ -287,8 +287,8 @@ msgstr ""
287287
#: ../../c-api/long.rst:287
288288
msgid ""
289289
"Return a C :c:expr:`unsigned long long` representation of *obj*. If *obj* "
290-
"is not an instance of :c:type:`PyLongObject`, first call its :meth:"
291-
"`__index__` method (if present) to convert it to a :c:type:`PyLongObject`."
290+
"is not an instance of :c:type:`PyLongObject`, first call its :meth:`~object."
291+
"__index__` method (if present) to convert it to a :c:type:`PyLongObject`."
292292
msgstr ""
293293

294294
#: ../../c-api/long.rst:292

0 commit comments

Comments
 (0)