Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit 9dbdf3d

Browse filesBrowse files
pydoc-zh-tw[bot]github-actions[bot]mattwang44
authored
Sync with CPython 3.11 (#377)
* sync with cpython 55a26de6 * sync with cpython d06315a6 * sync with cpython c7aa3928 * sync with cpython 31b82abb * sync with cpython 3ef9f6b5 * sync with cpython db65a326 * fix(using/windows): resolve fuzzy entry * sync with cpython db0eeb38 * fix(library/pathlib): resolve fuzzy entries * sync with cpython 69d12d86 * fix(library/random): resolve fuzzy entries Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Wei-Hsiang (Matt) Wang <mattwang44@gmail.com>
1 parent 2c0785d commit 9dbdf3d
Copy full SHA for 9dbdf3d

File tree

Expand file treeCollapse file tree

13 files changed

+590
-560
lines changed
Filter options
Expand file treeCollapse file tree

13 files changed

+590
-560
lines changed

‎howto/logging-cookbook.po

Copy file name to clipboardExpand all lines: howto/logging-cookbook.po
+149-151Lines changed: 149 additions & 151 deletions
Large diffs are not rendered by default.

‎library/asyncio-policy.po

Copy file name to clipboardExpand all lines: library/asyncio-policy.po
+5-4Lines changed: 5 additions & 4 deletions
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-01-11 00:15+0000\n"
11+
"POT-Creation-Date: 2023-01-14 00:15+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-"
@@ -147,9 +147,10 @@ msgstr ""
147147

148148
#: ../../library/asyncio-policy.rst:116
149149
msgid ""
150-
"In Python versions 3.10.9, 3.11.1 and 3.12 this function emits a :exc:"
151-
"`DeprecationWarning` if there is no running event loop and no current loop "
152-
"is set. In some future Python release this will become an error."
150+
"In Python versions 3.10.9, 3.11.1 and 3.12 the :meth:`get_event_loop` method "
151+
"of the default asyncio policy emits a :exc:`DeprecationWarning` if there is "
152+
"no running event loop and no current loop is set. In some future Python "
153+
"release this will become an error."
153154
msgstr ""
154155

155156
#: ../../library/asyncio-policy.rst:124

‎library/datetime.po

Copy file name to clipboardExpand all lines: library/datetime.po
+3-3Lines changed: 3 additions & 3 deletions
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: 2022-12-11 00:18+0000\n"
10+
"POT-Creation-Date: 2023-01-21 00:16+0000\n"
1111
"PO-Revision-Date: 2018-05-23 14:42+0000\n"
1212
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -1636,8 +1636,8 @@ msgstr ""
16361636
msgid ""
16371637
"Because naive ``datetime`` objects are treated by many ``datetime`` methods "
16381638
"as local times, it is preferred to use aware datetimes to represent times in "
1639-
"UTC; as a result, using ``utcfromtimetuple`` may give misleading results. If "
1640-
"you have a naive ``datetime`` representing UTC, use ``datetime."
1639+
"UTC; as a result, using :meth:`datetime.utctimetuple` may give misleading "
1640+
"results. If you have a naive ``datetime`` representing UTC, use ``datetime."
16411641
"replace(tzinfo=timezone.utc)`` to make it aware, at which point you can use :"
16421642
"meth:`.datetime.timetuple`."
16431643
msgstr ""

‎library/email.mime.po

Copy file name to clipboardExpand all lines: library/email.mime.po
+6-6Lines changed: 6 additions & 6 deletions
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: 2022-10-15 20:43+0000\n"
10+
"POT-Creation-Date: 2023-01-15 00:18+0000\n"
1111
"PO-Revision-Date: 2018-05-23 16:00+0000\n"
1212
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -165,9 +165,9 @@ msgstr "模組：\\ :mod:`email.mime.application`"
165165
msgid ""
166166
"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:"
167167
"`MIMEApplication` class is used to represent MIME message objects of major "
168-
"type :mimetype:`application`. *_data* is a string containing the raw byte "
169-
"data. Optional *_subtype* specifies the MIME subtype and defaults to :"
170-
"mimetype:`octet-stream`."
168+
"type :mimetype:`application`. *_data* contains the bytes for the raw "
169+
"application data. Optional *_subtype* specifies the MIME subtype and "
170+
"defaults to :mimetype:`octet-stream`."
171171
msgstr ""
172172

173173
#: ../../library/email.mime.rst:121
@@ -194,7 +194,7 @@ msgstr "模組：\\ :mod:`email.mime.audio`"
194194
msgid ""
195195
"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:"
196196
"`MIMEAudio` class is used to create MIME message objects of major type :"
197-
"mimetype:`audio`. *_audiodata* is a string containing the raw audio data. "
197+
"mimetype:`audio`. *_audiodata* contains the bytes for the raw audio data. "
198198
"If this data can be decoded as au, wav, aiff, or aifc, then the subtype will "
199199
"be automatically included in the :mailheader:`Content-Type` header. "
200200
"Otherwise you can explicitly specify the audio subtype via the *_subtype* "
@@ -222,7 +222,7 @@ msgstr "模組：\\ :mod:`email.mime.image`"
222222
msgid ""
223223
"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:"
224224
"`MIMEImage` class is used to create MIME message objects of major type :"
225-
"mimetype:`image`. *_imagedata* is a string containing the raw image data. "
225+
"mimetype:`image`. *_imagedata* contains the bytes for the raw image data. "
226226
"If this data type can be detected (jpeg, png, gif, tiff, rgb, pbm, pgm, ppm, "
227227
"rast, xbm, bmp, webp, and exr attempted), then the subtype will be "
228228
"automatically included in the :mailheader:`Content-Type` header. Otherwise "

‎library/enum.po

Copy file name to clipboardExpand all lines: library/enum.po
+26-26Lines changed: 26 additions & 26 deletions
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-01-04 00:15+0000\n"
10+
"POT-Creation-Date: 2023-01-21 00:16+0000\n"
1111
"PO-Revision-Date: 2018-05-23 16:01+0000\n"
1212
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -84,19 +84,19 @@ msgid "Nomenclature"
8484
msgstr ""
8585

8686
#: ../../library/enum.rst:55
87-
msgid "The class :class:`Color` is an *enumeration* (or *enum*)"
87+
msgid "The class :class:`!Color` is an *enumeration* (or *enum*)"
8888
msgstr ""
8989

9090
#: ../../library/enum.rst:56
9191
msgid ""
92-
"The attributes :attr:`Color.RED`, :attr:`Color.GREEN`, etc., are "
92+
"The attributes :attr:`!Color.RED`, :attr:`!Color.GREEN`, etc., are "
9393
"*enumeration members* (or *members*) and are functionally constants."
9494
msgstr ""
9595

9696
#: ../../library/enum.rst:58
9797
msgid ""
98-
"The enum members have *names* and *values* (the name of :attr:`Color.RED` is "
99-
"``RED``, the value of :attr:`Color.BLUE` is ``3``, etc.)"
98+
"The enum members have *names* and *values* (the name of :attr:`!Color.RED` "
99+
"is ``RED``, the value of :attr:`!Color.BLUE` is ``3``, etc.)"
100100
msgstr ""
101101

102102
#: ../../library/enum.rst:65
@@ -292,8 +292,8 @@ msgstr ""
292292

293293
#: ../../library/enum.rst:168
294294
msgid ""
295-
"*EnumType* is responsible for setting the correct :meth:`__repr__`, :meth:"
296-
"`__str__`, :meth:`__format__`, and :meth:`__reduce__` methods on the final "
295+
"*EnumType* is responsible for setting the correct :meth:`!__repr__`, :meth:`!"
296+
"__str__`, :meth:`!__format__`, and :meth:`!__reduce__` methods on the final "
297297
"*enum*, as well as creating the enum members, properly handling duplicates, "
298298
"providing iteration over the enum class, etc."
299299
msgstr ""
@@ -548,9 +548,9 @@ msgstr ""
548548

549549
#: ../../library/enum.rst:425
550550
msgid ""
551-
":meth:`__str__` is now :func:`int.__str__` to better support the "
552-
"*replacement of existing constants* use-case. :meth:`__format__` was "
553-
"already :func:`int.__format__` for that same reason."
551+
":meth:`~object.__str__` is now :meth:`!int.__str__` to better support the "
552+
"*replacement of existing constants* use-case. :meth:`~object.__format__` was "
553+
"already :meth:`!int.__format__` for that same reason."
554554
msgstr ""
555555

556556
#: ../../library/enum.rst:432
@@ -693,7 +693,7 @@ msgstr ""
693693

694694
#: ../../library/enum.rst:616
695695
msgid ""
696-
":class:`!ReprEum` uses the :meth:`repr() <Enum.__repr__>` of :class:`Enum`, "
696+
":class:`!ReprEnum` uses the :meth:`repr() <Enum.__repr__>` of :class:`Enum`, "
697697
"but the :class:`str() <str>` of the mixed-in data type:"
698698
msgstr ""
699699

@@ -775,15 +775,15 @@ msgstr ""
775775

776776
#: ../../library/enum.rst:756
777777
msgid ""
778-
":attr:`__members__` is a read-only ordered mapping of ``member_name``:"
779-
"``member`` items. It is only available on the class."
778+
":attr:`~EnumType.__members__` is a read-only ordered mapping of "
779+
"``member_name``:``member`` items. It is only available on the class."
780780
msgstr ""
781781

782782
#: ../../library/enum.rst:759
783783
msgid ""
784-
":meth:`__new__`, if specified, must create and return the enum members; it "
785-
"is also a very good idea to set the member's :attr:`_value_` appropriately. "
786-
"Once all the members are created it is no longer used."
784+
":meth:`~object.__new__`, if specified, must create and return the enum "
785+
"members; it is also a very good idea to set the member's :attr:`!_value_` "
786+
"appropriately. Once all the members are created it is no longer used."
787787
msgstr ""
788788

789789
#: ../../library/enum.rst:765
@@ -851,12 +851,12 @@ msgstr ""
851851
#: ../../library/enum.rst:798
852852
msgid ""
853853
"*auto* can be used in place of a value. If used, the *Enum* machinery will "
854-
"call an *Enum*'s :meth:`_generate_next_value_` to get an appropriate value. "
855-
"For *Enum* and *IntEnum* that appropriate value will be the last value plus "
856-
"one; for *Flag* and *IntFlag* it will be the first power-of-two greater than "
857-
"the highest value; for *StrEnum* it will be the lower-cased version of the "
858-
"member's name. Care must be taken if mixing *auto()* with manually "
859-
"specified values."
854+
"call an *Enum*'s :meth:`~Enum._generate_next_value_` to get an appropriate "
855+
"value. For *Enum* and *IntEnum* that appropriate value will be the last "
856+
"value plus one; for *Flag* and *IntFlag* it will be the first power-of-two "
857+
"greater than the highest value; for *StrEnum* it will be the lower-cased "
858+
"version of the member's name. Care must be taken if mixing *auto()* with "
859+
"manually specified values."
860860
msgstr ""
861861

862862
#: ../../library/enum.rst:806
@@ -898,8 +898,8 @@ msgstr ""
898898

899899
#: ../../library/enum.rst:822
900900
msgid ""
901-
"in 3.13 the default ``\"generate_next_value_`` will always return the "
902-
"highest member value incremented by 1, and will fail if any member is an "
901+
"in 3.13 the default ``_generate_next_value_`` will always return the highest "
902+
"member value incremented by 1, and will fail if any member is an "
903903
"incompatible type."
904904
msgstr ""
905905

@@ -921,8 +921,8 @@ msgstr ""
921921
#: ../../library/enum.rst:841
922922
msgid ""
923923
"A :keyword:`class` decorator specifically for enumerations. It searches an "
924-
"enumeration's :attr:`__members__`, gathering any aliases it finds; if any "
925-
"are found :exc:`ValueError` is raised with the details::"
924+
"enumeration's :attr:`~EnumType.__members__`, gathering any aliases it finds; "
925+
"if any are found :exc:`ValueError` is raised with the details::"
926926
msgstr ""
927927

928928
#: ../../library/enum.rst:859

‎library/optparse.po

Copy file name to clipboardExpand all lines: library/optparse.po
+35-35Lines changed: 35 additions & 35 deletions
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: 2022-07-06 00:17+0000\n"
10+
"POT-Creation-Date: 2023-01-21 00:16+0000\n"
1111
"PO-Revision-Date: 2018-05-23 16:07+0000\n"
1212
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -152,8 +152,8 @@ msgstr ""
152152

153153
#: ../../library/optparse.rst:125
154154
msgid ""
155-
"a plus sign followed by a single letter, or a few letters, or a word, e.g. ``"
156-
"+f``, ``+rgb``"
155+
"a plus sign followed by a single letter, or a few letters, or a word, e.g. "
156+
"``+f``, ``+rgb``"
157157
msgstr ""
158158

159159
#: ../../library/optparse.rst:128
@@ -527,7 +527,7 @@ msgid "``\"store_const\"``"
527527
msgstr "``\"store_const\"``"
528528

529529
#: ../../library/optparse.rst:407 ../../library/optparse.rst:928
530-
msgid "store a constant value"
530+
msgid "store a constant value, pre-set via :attr:`Option.const`"
531531
msgstr ""
532532

533533
#: ../../library/optparse.rst:410 ../../library/optparse.rst:937
@@ -566,10 +566,10 @@ msgstr ""
566566

567567
#: ../../library/optparse.rst:427
568568
msgid ""
569-
"All of the above examples involve setting some variable (the \"destination"
570-
"\") when certain command-line options are seen. What happens if those "
571-
"options are never seen? Since we didn't supply any defaults, they are all "
572-
"set to ``None``. This is usually fine, but sometimes you want more "
569+
"All of the above examples involve setting some variable (the "
570+
"\"destination\") when certain command-line options are seen. What happens "
571+
"if those options are never seen? Since we didn't supply any defaults, they "
572+
"are all set to ``None``. This is usually fine, but sometimes you want more "
573573
"control. :mod:`optparse` lets you supply a default value for each "
574574
"destination, which is assigned before the command line is parsed."
575575
msgstr ""
@@ -813,8 +813,8 @@ msgstr ""
813813
#: ../../library/optparse.rst:692
814814
msgid ""
815815
"Print the version message for the current program (``self.version``) to "
816-
"*file* (default stdout). As with :meth:`print_usage`, any occurrence of ``"
817-
"%prog`` in ``self.version`` is replaced with the name of the current "
816+
"*file* (default stdout). As with :meth:`print_usage`, any occurrence of "
817+
"``%prog`` in ``self.version`` is replaced with the name of the current "
818818
"program. Does nothing if ``self.version`` is empty or undefined."
819819
msgstr ""
820820

@@ -916,8 +916,8 @@ msgstr ""
916916
#: ../../library/optparse.rst:810
917917
msgid ""
918918
"The usage summary to print when your program is run incorrectly or with a "
919-
"help option. When :mod:`optparse` prints the usage string, it expands ``"
920-
"%prog`` to ``os.path.basename(sys.argv[0])`` (or to ``prog`` if you passed "
919+
"help option. When :mod:`optparse` prints the usage string, it expands "
920+
"``%prog`` to ``os.path.basename(sys.argv[0])`` (or to ``prog`` if you passed "
921921
"that keyword argument). To suppress a usage message, pass the special "
922922
"value :data:`optparse.SUPPRESS_USAGE`."
923923
msgstr ""
@@ -951,8 +951,8 @@ msgstr ""
951951
msgid ""
952952
"A version string to print when the user supplies a version option. If you "
953953
"supply a true value for ``version``, :mod:`optparse` automatically adds a "
954-
"version option with the single option string ``--version``. The substring ``"
955-
"%prog`` is expanded the same as for ``usage``."
954+
"version option with the single option string ``--version``. The substring "
955+
"``%prog`` is expanded the same as for ``usage``."
956956
msgstr ""
957957

958958
#: ../../library/optparse.rst:835
@@ -1123,7 +1123,7 @@ msgid "``\"append_const\"``"
11231123
msgstr "``\"append_const\"``"
11241124

11251125
#: ../../library/optparse.rst:940
1126-
msgid "append a constant value to a list"
1126+
msgid "append a constant value to a list, pre-set via :attr:`Option.const`"
11271127
msgstr ""
11281128

11291129
#: ../../library/optparse.rst:949 ../../library/optparse.rst:1226
@@ -1214,8 +1214,8 @@ msgstr ""
12141214

12151215
#: ../../library/optparse.rst:1011
12161216
msgid ""
1217-
"The argument type expected by this option (e.g., ``\"string\"`` or ``\"int"
1218-
"\"``); the available option types are documented :ref:`here <optparse-"
1217+
"The argument type expected by this option (e.g., ``\"string\"`` or "
1218+
"``\"int\"``); the available option types are documented :ref:`here <optparse-"
12191219
"standard-option-types>`."
12201220
msgstr ""
12211221

@@ -1770,11 +1770,11 @@ msgstr ""
17701770
#: ../../library/optparse.rst:1452
17711771
msgid ""
17721772
"At this point, :mod:`optparse` detects that a previously added option is "
1773-
"already using the ``-n`` option string. Since ``conflict_handler`` is ``"
1774-
"\"resolve\"``, it resolves the situation by removing ``-n`` from the earlier "
1775-
"option's list of option strings. Now ``--dry-run`` is the only way for the "
1776-
"user to activate that option. If the user asks for help, the help message "
1777-
"will reflect that::"
1773+
"already using the ``-n`` option string. Since ``conflict_handler`` is "
1774+
"``\"resolve\"``, it resolves the situation by removing ``-n`` from the "
1775+
"earlier option's list of option strings. Now ``--dry-run`` is the only way "
1776+
"for the user to activate that option. If the user asks for help, the help "
1777+
"message will reflect that::"
17781778
msgstr ""
17791779

17801780
#: ../../library/optparse.rst:1463
@@ -1982,8 +1982,8 @@ msgid ""
19821982
"is the option string seen on the command-line that's triggering the "
19831983
"callback. (If an abbreviated long option was used, ``opt_str`` will be the "
19841984
"full, canonical option string---e.g. if the user puts ``--foo`` on the "
1985-
"command-line as an abbreviation for ``--foobar``, then ``opt_str`` will be ``"
1986-
"\"--foobar\"``.)"
1985+
"command-line as an abbreviation for ``--foobar``, then ``opt_str`` will be "
1986+
"``\"--foobar\"``.)"
19871987
msgstr ""
19881988

19891989
#: ../../library/optparse.rst:1637
@@ -2333,10 +2333,10 @@ msgstr ""
23332333

23342334
#: ../../library/optparse.rst:1950
23352335
msgid ""
2336-
"These are overlapping sets: some default \"store\" actions are ``\"store"
2337-
"\"``, ``\"store_const\"``, ``\"append\"``, and ``\"count\"``, while the "
2338-
"default \"typed\" actions are ``\"store\"``, ``\"append\"``, and ``\"callback"
2339-
"\"``."
2336+
"These are overlapping sets: some default \"store\" actions are "
2337+
"``\"store\"``, ``\"store_const\"``, ``\"append\"``, and ``\"count\"``, while "
2338+
"the default \"typed\" actions are ``\"store\"``, ``\"append\"``, and "
2339+
"``\"callback\"``."
23402340
msgstr ""
23412341

23422342
#: ../../library/optparse.rst:1954
@@ -2425,11 +2425,11 @@ msgstr ""
24252425
msgid ""
24262426
"If the ``attr`` attribute of ``values`` doesn't exist or is ``None``, then "
24272427
"ensure_value() first sets it to ``value``, and then returns 'value. This is "
2428-
"very handy for actions like ``\"extend\"``, ``\"append\"``, and ``\"count"
2429-
"\"``, all of which accumulate data in a variable and expect that variable to "
2430-
"be of a certain type (a list for the first two, an integer for the latter). "
2431-
"Using :meth:`ensure_value` means that scripts using your action don't have "
2432-
"to worry about setting a default value for the option destinations in "
2433-
"question; they can just leave the default as ``None`` and :meth:"
2434-
"`ensure_value` will take care of getting it right when it's needed."
2428+
"very handy for actions like ``\"extend\"``, ``\"append\"``, and "
2429+
"``\"count\"``, all of which accumulate data in a variable and expect that "
2430+
"variable to be of a certain type (a list for the first two, an integer for "
2431+
"the latter). Using :meth:`ensure_value` means that scripts using your "
2432+
"action don't have to worry about setting a default value for the option "
2433+
"destinations in question; they can just leave the default as ``None`` and :"
2434+
"meth:`ensure_value` will take care of getting it right when it's needed."
24352435
msgstr ""

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.