Skip to content

Commit 9aad6fe

Browse files
pydoc-zh-tw[bot]github-actions[bot]mattwang44
authored
Sync with CPython 3.10 (#202)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Matt.Wang <mattwang44@gmail.com>
1 parent 6ad4548 commit 9aad6fe

File tree

7 files changed

+386
-244
lines changed

7 files changed

+386
-244
lines changed

‎c-api/init_config.po

+2-2
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python 3.10\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2021-10-26 16:47+0000\n"
11+
"POT-Creation-Date: 2022-01-22 00:09+0000\n"
1212
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -805,7 +805,7 @@ msgid "If non-zero, enable the :ref:`Python Development Mode <devmode>`."
805805
msgstr ""
806806

807807
#: ../../c-api/init_config.rst:637
808-
msgid "Dump Python refererences?"
808+
msgid "Dump Python references?"
809809
msgstr ""
810810

811811
#: ../../c-api/init_config.rst:639

‎c-api/object.po

+41-40
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.10\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2021-10-26 16:47+0000\n"
10+
"POT-Creation-Date: 2022-01-20 00:10+0000\n"
1111
"PO-Revision-Date: 2018-05-23 14:32+0000\n"
1212
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -89,7 +89,7 @@ msgid ""
8989
"descriptors don't. Otherwise, an :exc:`AttributeError` is raised."
9090
msgstr ""
9191

92-
#: ../../c-api/object.rst:79 ../../c-api/object.rst:90
92+
#: ../../c-api/object.rst:79 ../../c-api/object.rst:91
9393
msgid ""
9494
"Set the value of the attribute named *attr_name*, for object *o*, to the "
9595
"value *v*. Raise an exception and return ``-1`` on failure; return ``0`` on "
@@ -98,17 +98,18 @@ msgstr ""
9898

9999
#: ../../c-api/object.rst:84
100100
msgid ""
101-
"If *v* is ``NULL``, the attribute is deleted, however this feature is "
102-
"deprecated in favour of using :c:func:`PyObject_DelAttr`."
101+
"If *v* is ``NULL``, the attribute is deleted. This behaviour is deprecated "
102+
"in favour of using :c:func:`PyObject_DelAttr`, but there are currently no "
103+
"plans to remove it."
103104
msgstr ""
104105

105-
#: ../../c-api/object.rst:95
106+
#: ../../c-api/object.rst:96
106107
msgid ""
107108
"If *v* is ``NULL``, the attribute is deleted, however this feature is "
108109
"deprecated in favour of using :c:func:`PyObject_DelAttrString`."
109110
msgstr ""
110111

111-
#: ../../c-api/object.rst:101
112+
#: ../../c-api/object.rst:102
112113
msgid ""
113114
"Generic attribute setter and deleter function that is meant to be put into a "
114115
"type object's :c:member:`~PyTypeObject.tp_setattro` slot. It looks for a "
@@ -120,25 +121,25 @@ msgid ""
120121
"returned."
121122
msgstr ""
122123

123-
#: ../../c-api/object.rst:113 ../../c-api/object.rst:119
124+
#: ../../c-api/object.rst:114 ../../c-api/object.rst:120
124125
msgid ""
125126
"Delete attribute named *attr_name*, for object *o*. Returns ``-1`` on "
126127
"failure. This is the equivalent of the Python statement ``del o.attr_name``."
127128
msgstr ""
128129

129-
#: ../../c-api/object.rst:125
130+
#: ../../c-api/object.rst:126
130131
msgid ""
131132
"A generic implementation for the getter of a ``__dict__`` descriptor. It "
132133
"creates the dictionary if necessary."
133134
msgstr ""
134135

135-
#: ../../c-api/object.rst:133
136+
#: ../../c-api/object.rst:134
136137
msgid ""
137138
"A generic implementation for the setter of a ``__dict__`` descriptor. This "
138139
"implementation does not allow the dictionary to be deleted."
139140
msgstr ""
140141

141-
#: ../../c-api/object.rst:141
142+
#: ../../c-api/object.rst:142
142143
msgid ""
143144
"Compare the values of *o1* and *o2* using the operation specified by *opid*, "
144145
"which must be one of :const:`Py_LT`, :const:`Py_LE`, :const:`Py_EQ`, :const:"
@@ -149,7 +150,7 @@ msgid ""
149150
"failure."
150151
msgstr ""
151152

152-
#: ../../c-api/object.rst:151
153+
#: ../../c-api/object.rst:152
153154
msgid ""
154155
"Compare the values of *o1* and *o2* using the operation specified by *opid*, "
155156
"which must be one of :const:`Py_LT`, :const:`Py_LE`, :const:`Py_EQ`, :const:"
@@ -160,27 +161,27 @@ msgid ""
160161
"to *opid*."
161162
msgstr ""
162163

163-
#: ../../c-api/object.rst:160
164+
#: ../../c-api/object.rst:161
164165
msgid ""
165166
"If *o1* and *o2* are the same object, :c:func:`PyObject_RichCompareBool` "
166167
"will always return ``1`` for :const:`Py_EQ` and ``0`` for :const:`Py_NE`."
167168
msgstr ""
168169

169-
#: ../../c-api/object.rst:167
170+
#: ../../c-api/object.rst:168
170171
msgid ""
171172
"Compute a string representation of object *o*. Returns the string "
172173
"representation on success, ``NULL`` on failure. This is the equivalent of "
173174
"the Python expression ``repr(o)``. Called by the :func:`repr` built-in "
174175
"function."
175176
msgstr ""
176177

177-
#: ../../c-api/object.rst:171 ../../c-api/object.rst:195
178+
#: ../../c-api/object.rst:172 ../../c-api/object.rst:196
178179
msgid ""
179180
"This function now includes a debug assertion to help ensure that it does not "
180181
"silently discard an active exception."
181182
msgstr ""
182183

183-
#: ../../c-api/object.rst:179
184+
#: ../../c-api/object.rst:180
184185
msgid ""
185186
"As :c:func:`PyObject_Repr`, compute a string representation of object *o*, "
186187
"but escape the non-ASCII characters in the string returned by :c:func:"
@@ -189,15 +190,15 @@ msgid ""
189190
"Called by the :func:`ascii` built-in function."
190191
msgstr ""
191192

192-
#: ../../c-api/object.rst:190
193+
#: ../../c-api/object.rst:191
193194
msgid ""
194195
"Compute a string representation of object *o*. Returns the string "
195196
"representation on success, ``NULL`` on failure. This is the equivalent of "
196197
"the Python expression ``str(o)``. Called by the :func:`str` built-in "
197198
"function and, therefore, by the :func:`print` function."
198199
msgstr ""
199200

200-
#: ../../c-api/object.rst:204
201+
#: ../../c-api/object.rst:205
201202
msgid ""
202203
"Compute a bytes representation of object *o*. ``NULL`` is returned on "
203204
"failure and a bytes object on success. This is equivalent to the Python "
@@ -206,95 +207,95 @@ msgid ""
206207
"bytes object."
207208
msgstr ""
208209

209-
#: ../../c-api/object.rst:213
210+
#: ../../c-api/object.rst:214
210211
msgid ""
211212
"Return ``1`` if the class *derived* is identical to or derived from the "
212213
"class *cls*, otherwise return ``0``. In case of an error, return ``-1``."
213214
msgstr ""
214215

215-
#: ../../c-api/object.rst:216 ../../c-api/object.rst:235
216+
#: ../../c-api/object.rst:217 ../../c-api/object.rst:236
216217
msgid ""
217218
"If *cls* is a tuple, the check will be done against every entry in *cls*. "
218219
"The result will be ``1`` when at least one of the checks returns ``1``, "
219220
"otherwise it will be ``0``."
220221
msgstr ""
221222

222-
#: ../../c-api/object.rst:220
223+
#: ../../c-api/object.rst:221
223224
msgid ""
224225
"If *cls* has a :meth:`~class.__subclasscheck__` method, it will be called to "
225226
"determine the subclass status as described in :pep:`3119`. Otherwise, "
226227
"*derived* is a subclass of *cls* if it is a direct or indirect subclass, i."
227228
"e. contained in ``cls.__mro__``."
228229
msgstr ""
229230

230-
#: ../../c-api/object.rst:225
231+
#: ../../c-api/object.rst:226
231232
msgid ""
232233
"Normally only class objects, i.e. instances of :class:`type` or a derived "
233234
"class, are considered classes. However, objects can override this by having "
234235
"a :attr:`__bases__` attribute (which must be a tuple of base classes)."
235236
msgstr ""
236237

237-
#: ../../c-api/object.rst:232
238+
#: ../../c-api/object.rst:233
238239
msgid ""
239240
"Return ``1`` if *inst* is an instance of the class *cls* or a subclass of "
240241
"*cls*, or ``0`` if not. On error, returns ``-1`` and sets an exception."
241242
msgstr ""
242243

243-
#: ../../c-api/object.rst:239
244+
#: ../../c-api/object.rst:240
244245
msgid ""
245246
"If *cls* has a :meth:`~class.__instancecheck__` method, it will be called to "
246247
"determine the subclass status as described in :pep:`3119`. Otherwise, "
247248
"*inst* is an instance of *cls* if its class is a subclass of *cls*."
248249
msgstr ""
249250

250-
#: ../../c-api/object.rst:243
251+
#: ../../c-api/object.rst:244
251252
msgid ""
252253
"An instance *inst* can override what is considered its class by having a :"
253254
"attr:`__class__` attribute."
254255
msgstr ""
255256

256-
#: ../../c-api/object.rst:246
257+
#: ../../c-api/object.rst:247
257258
msgid ""
258259
"An object *cls* can override if it is considered a class, and what its base "
259260
"classes are, by having a :attr:`__bases__` attribute (which must be a tuple "
260261
"of base classes)."
261262
msgstr ""
262263

263-
#: ../../c-api/object.rst:255
264+
#: ../../c-api/object.rst:256
264265
msgid ""
265266
"Compute and return the hash value of an object *o*. On failure, return "
266267
"``-1``. This is the equivalent of the Python expression ``hash(o)``."
267268
msgstr ""
268269

269-
#: ../../c-api/object.rst:258
270+
#: ../../c-api/object.rst:259
270271
msgid ""
271272
"The return type is now Py_hash_t. This is a signed integer the same size as "
272273
"Py_ssize_t."
273274
msgstr ""
274275

275-
#: ../../c-api/object.rst:265
276+
#: ../../c-api/object.rst:266
276277
msgid ""
277278
"Set a :exc:`TypeError` indicating that ``type(o)`` is not hashable and "
278279
"return ``-1``. This function receives special treatment when stored in a "
279280
"``tp_hash`` slot, allowing a type to explicitly indicate to the interpreter "
280281
"that it is not hashable."
281282
msgstr ""
282283

283-
#: ../../c-api/object.rst:273
284+
#: ../../c-api/object.rst:274
284285
msgid ""
285286
"Returns ``1`` if the object *o* is considered to be true, and ``0`` "
286287
"otherwise. This is equivalent to the Python expression ``not not o``. On "
287288
"failure, return ``-1``."
288289
msgstr ""
289290

290-
#: ../../c-api/object.rst:280
291+
#: ../../c-api/object.rst:281
291292
msgid ""
292293
"Returns ``0`` if the object *o* is considered to be true, and ``1`` "
293294
"otherwise. This is equivalent to the Python expression ``not o``. On "
294295
"failure, return ``-1``."
295296
msgstr ""
296297

297-
#: ../../c-api/object.rst:289
298+
#: ../../c-api/object.rst:290
298299
msgid ""
299300
"When *o* is non-``NULL``, returns a type object corresponding to the object "
300301
"type of object *o*. On failure, raises :exc:`SystemError` and returns "
@@ -305,21 +306,21 @@ msgid ""
305306
"when the incremented reference count is needed."
306307
msgstr ""
307308

308-
#: ../../c-api/object.rst:300
309+
#: ../../c-api/object.rst:301
309310
msgid ""
310311
"Return non-zero if the object *o* is of type *type* or a subtype of *type*, "
311312
"and ``0`` otherwise. Both parameters must be non-``NULL``."
312313
msgstr ""
313314

314-
#: ../../c-api/object.rst:309
315+
#: ../../c-api/object.rst:310
315316
msgid ""
316317
"Return the length of object *o*. If the object *o* provides either the "
317318
"sequence and mapping protocols, the sequence length is returned. On error, "
318319
"``-1`` is returned. This is the equivalent to the Python expression "
319320
"``len(o)``."
320321
msgstr ""
321322

322-
#: ../../c-api/object.rst:316
323+
#: ../../c-api/object.rst:317
323324
msgid ""
324325
"Return an estimated length for the object *o*. First try to return its "
325326
"actual length, then an estimate using :meth:`~object.__length_hint__`, and "
@@ -328,26 +329,26 @@ msgid ""
328329
"defaultvalue)``."
329330
msgstr ""
330331

331-
#: ../../c-api/object.rst:326
332+
#: ../../c-api/object.rst:327
332333
msgid ""
333334
"Return element of *o* corresponding to the object *key* or ``NULL`` on "
334335
"failure. This is the equivalent of the Python expression ``o[key]``."
335336
msgstr ""
336337

337-
#: ../../c-api/object.rst:332
338+
#: ../../c-api/object.rst:333
338339
msgid ""
339340
"Map the object *key* to the value *v*. Raise an exception and return ``-1`` "
340341
"on failure; return ``0`` on success. This is the equivalent of the Python "
341342
"statement ``o[key] = v``. This function *does not* steal a reference to *v*."
342343
msgstr ""
343344

344-
#: ../../c-api/object.rst:340
345+
#: ../../c-api/object.rst:341
345346
msgid ""
346347
"Remove the mapping for the object *key* from the object *o*. Return ``-1`` "
347348
"on failure. This is equivalent to the Python statement ``del o[key]``."
348349
msgstr ""
349350

350-
#: ../../c-api/object.rst:346
351+
#: ../../c-api/object.rst:347
351352
msgid ""
352353
"This is equivalent to the Python expression ``dir(o)``, returning a "
353354
"(possibly empty) list of strings appropriate for the object argument, or "
@@ -357,15 +358,15 @@ msgid ""
357358
"`PyErr_Occurred` will return false."
358359
msgstr ""
359360

360-
#: ../../c-api/object.rst:355
361+
#: ../../c-api/object.rst:356
361362
msgid ""
362363
"This is equivalent to the Python expression ``iter(o)``. It returns a new "
363364
"iterator for the object argument, or the object itself if the object is "
364365
"already an iterator. Raises :exc:`TypeError` and returns ``NULL`` if the "
365366
"object cannot be iterated."
366367
msgstr ""
367368

368-
#: ../../c-api/object.rst:363
369+
#: ../../c-api/object.rst:364
369370
msgid ""
370371
"This is the equivalent to the Python expression ``aiter(o)``. Takes an :"
371372
"class:`AsyncIterable` object and returns an :class:`AsyncIterator` for it. "

‎library/calendar.po

+12-6
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.10\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2021-09-13 00:11+0000\n"
10+
"POT-Creation-Date: 2022-01-24 00:09+0000\n"
1111
"PO-Revision-Date: 2018-05-23 14:40+0000\n"
1212
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -51,7 +51,8 @@ msgstr ""
5151
#: ../../library/calendar.rst:33
5252
msgid ""
5353
"Creates a :class:`Calendar` object. *firstweekday* is an integer specifying "
54-
"the first day of the week. ``0`` is Monday (the default), ``6`` is Sunday."
54+
"the first day of the week. :const:`MONDAY` is ``0`` (the default), :const:"
55+
"`SUNDAY` is ``6``."
5556
msgstr ""
5657

5758
#: ../../library/calendar.rst:36
@@ -422,20 +423,25 @@ msgid ""
422423
"it has a length of 13 and ``month_abbr[0]`` is the empty string."
423424
msgstr ""
424425

425-
#: ../../library/calendar.rst:417
426+
#: ../../library/calendar.rst:420
427+
msgid ""
428+
"Aliases for day numbers, where ``MONDAY`` is ``0`` and ``SUNDAY`` is ``6``."
429+
msgstr ""
430+
431+
#: ../../library/calendar.rst:426
426432
msgid "Module :mod:`datetime`"
427433
msgstr ":mod:`datetime` 模組"
428434

429-
#: ../../library/calendar.rst:416
435+
#: ../../library/calendar.rst:425
430436
msgid ""
431437
"Object-oriented interface to dates and times with similar functionality to "
432438
"the :mod:`time` module."
433439
msgstr ""
434440

435-
#: ../../library/calendar.rst:419
441+
#: ../../library/calendar.rst:428
436442
msgid "Module :mod:`time`"
437443
msgstr ":mod:`time` 模組"
438444

439-
#: ../../library/calendar.rst:420
445+
#: ../../library/calendar.rst:429
440446
msgid "Low-level time related functions."
441447
msgstr ""

0 commit comments

Comments
 (0)