sync with cpython 5c06b346

github-actions[bot] · mattwang44 · commit 680cf2a75742 · 2024-07-18T16:18:46.000+08:00
diff --git a/library/pprint.po b/library/pprint.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-05-09 00:03+0000\n"
+"POT-Creation-Date: 2024-06-29 00:03+0000\n"
 "PO-Revision-Date: 2018-05-23 16:08+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -59,61 +59,97 @@ msgstr ""
 msgid "Functions"
 msgstr ""
 
-#: ../../library/pprint.rst:40
+#: ../../library/pprint.rst:41
 msgid ""
-"Prints the formatted representation of *object* followed by a newline. If "
-"*sort_dicts* is false (the default), dictionaries will be displayed with "
-"their keys in insertion order, otherwise the dict keys will be sorted. "
-"*args* and *kwargs* will be passed to :func:`~pprint.pprint` as formatting "
-"parameters."
+"Prints the formatted representation of *object*, followed by a newline. This "
+"function may be used in the interactive interpreter instead of the :func:"
+"`print` function for inspecting values. Tip: you can reassign ``print = "
+"pprint.pp`` for use within a scope."
+msgstr ""
+
+#: ../../library/pprint.rst:0
+msgid "Parameters"
+msgstr ""
+
+#: ../../library/pprint.rst:46
+msgid "The object to be printed."
+msgstr ""
+
+#: ../../library/pprint.rst:49
+msgid ""
+"A file-like object to which the output will be written by calling its :meth:"
+"`!write` method. If ``None`` (the default), :data:`sys.stdout` is used."
+msgstr ""
+
+#: ../../library/pprint.rst:55
+msgid "The amount of indentation added for each nesting level."
+msgstr ""
+
+#: ../../library/pprint.rst:58
+msgid ""
+"The desired maximum number of characters per line in the output. If a "
+"structure cannot be formatted within the width constraint, a best effort "
+"will be made."
 msgstr ""
 
 #: ../../library/pprint.rst:63
 msgid ""
-"Prints the formatted representation of *object* on *stream*, followed by a "
-"newline.  If *stream* is ``None``, :data:`sys.stdout` is used. This may be "
-"used in the interactive interpreter instead of the :func:`print` function "
-"for inspecting values (you can even reassign ``print = pprint.pprint`` for "
-"use within a scope)."
+"The number of nesting levels which may be printed. If the data structure "
+"being printed is too deep, the next contained level is replaced by ``...``. "
+"If ``None`` (the default), there is no constraint on the depth of the "
+"objects being formatted."
 msgstr ""
 
-#: ../../library/pprint.rst:69
+#: ../../library/pprint.rst:71
 msgid ""
-"The configuration parameters *stream*, *indent*, *width*, *depth*, "
-"*compact*, *sort_dicts* and *underscore_numbers* are passed to the :class:"
-"`PrettyPrinter` constructor and their meanings are as described in its "
-"documentation below."
+"Control the way long :term:`sequences <sequence>` are formatted. If "
+"``False`` (the default), each item of a sequence will be formatted on a "
+"separate line, otherwise as many items as will fit within the *width* will "
+"be formatted on each output line."
 msgstr ""
 
-#: ../../library/pprint.rst:74
+#: ../../library/pprint.rst:78
 msgid ""
-"Note that *sort_dicts* is ``True`` by default and you might want to use :"
-"func:`~pprint.pp` instead where it is ``False`` by default."
+"If ``True``, dictionaries will be formatted with their keys sorted, "
+"otherwise they will be displayed in insertion order (the default)."
 msgstr ""
 
-#: ../../library/pprint.rst:80
+#: ../../library/pprint.rst:83
+msgid ""
+"If ``True``, integers will be formatted with the ``_`` character for a "
+"thousands separator, otherwise underscores are not displayed (the default)."
+msgstr ""
+
+#: ../../library/pprint.rst:105
+msgid ""
+"Alias for :func:`~pprint.pp` with *sort_dicts* set to ``True`` by default, "
+"which would automatically sort the dictionaries' keys, you might want to "
+"use :func:`~pprint.pp` instead where it is ``False`` by default."
+msgstr ""
+
+#: ../../library/pprint.rst:113
 msgid ""
 "Return the formatted representation of *object* as a string.  *indent*, "
 "*width*, *depth*, *compact*, *sort_dicts* and *underscore_numbers* are "
 "passed to the :class:`PrettyPrinter` constructor as formatting parameters "
-"and their meanings are as described in its documentation below."
+"and their meanings are as described in the documentation above."
 msgstr ""
 
-#: ../../library/pprint.rst:90
+#: ../../library/pprint.rst:123
 msgid ""
 "Determine if the formatted representation of *object* is \"readable\", or "
 "can be used to reconstruct the value using :func:`eval`.  This always "
 "returns ``False`` for recursive objects."
 msgstr ""
 
-#: ../../library/pprint.rst:100
+#: ../../library/pprint.rst:133
 msgid ""
 "Determine if *object* requires a recursive representation.  This function is "
 "subject to the same limitations as noted in :func:`saferepr` below and may "
 "raise an :exc:`RecursionError` if it fails to detect a recursive object."
 msgstr ""
 
-#: ../../library/pprint.rst:107
+#: ../../library/pprint.rst:140
 msgid ""
 "Return a string representation of *object*, protected against recursion in "
 "some common data structures, namely instances of :class:`dict`, :class:"
@@ -123,117 +159,61 @@ msgid ""
 "id=number>``.  The representation is not otherwise formatted."
 msgstr ""
 
-#: ../../library/pprint.rst:120
+#: ../../library/pprint.rst:153
 msgid "PrettyPrinter Objects"
 msgstr "PrettyPrinter 物件"
 
-#: ../../library/pprint.rst:122
-msgid "This module defines one class:"
+#: ../../library/pprint.rst:160
+msgid "Construct a :class:`PrettyPrinter` instance."
 msgstr ""
 
-#: ../../library/pprint.rst:132
-msgid ""
-"Construct a :class:`PrettyPrinter` instance.  This constructor understands "
-"several keyword parameters."
-msgstr ""
-
-#: ../../library/pprint.rst:135
-msgid ""
-"*stream* (default :data:`!sys.stdout`) is a :term:`file-like object` to "
-"which the output will be written by calling its :meth:`!write` method. If "
-"both *stream* and :data:`!sys.stdout` are ``None``, then :meth:"
-"`~PrettyPrinter.pprint` silently returns."
-msgstr ""
-
-#: ../../library/pprint.rst:140
+#: ../../library/pprint.rst:162
 msgid ""
-"Other values configure the manner in which nesting of complex data "
-"structures is displayed."
+"Arguments have the same meaning as for :func:`~pprint.pp`. Note that they "
+"are in a different order, and that *sort_dicts* defaults to ``True``."
 msgstr ""
 
-#: ../../library/pprint.rst:143
-msgid ""
-"*indent* (default 1) specifies the amount of indentation added for each "
-"nesting level."
-msgstr ""
-
-#: ../../library/pprint.rst:146
-msgid ""
-"*depth* controls the number of nesting levels which may be printed; if the "
-"data structure being printed is too deep, the next contained level is "
-"replaced by ``...``.  By default, there is no constraint on the depth of the "
-"objects being formatted."
-msgstr ""
-
-#: ../../library/pprint.rst:151
-msgid ""
-"*width* (default 80) specifies the desired maximum number of characters per "
-"line in the output. If a structure cannot be formatted within the width "
-"constraint, a best effort will be made."
-msgstr ""
-
-#: ../../library/pprint.rst:155
-msgid ""
-"*compact* impacts the way that long sequences (lists, tuples, sets, etc) are "
-"formatted. If *compact* is false (the default) then each item of a sequence "
-"will be formatted on a separate line.  If *compact* is true, as many items "
-"as will fit within the *width* will be formatted on each output line."
-msgstr ""
-
-#: ../../library/pprint.rst:161
-msgid ""
-"If *sort_dicts* is true (the default), dictionaries will be formatted with "
-"their keys sorted, otherwise they will display in insertion order."
-msgstr ""
-
-#: ../../library/pprint.rst:164
-msgid ""
-"If *underscore_numbers* is true, integers will be formatted with the ``_`` "
-"character for a thousands separator, otherwise underscores are not displayed "
-"(the default)."
-msgstr ""
-
-#: ../../library/pprint.rst:168
+#: ../../library/pprint.rst:189
 msgid "Added the *compact* parameter."
 msgstr "新增 *compact* 參數。"
 
-#: ../../library/pprint.rst:171
+#: ../../library/pprint.rst:192
 msgid "Added the *sort_dicts* parameter."
 msgstr "新增 *sort_dicts* 參數。"
 
-#: ../../library/pprint.rst:174
+#: ../../library/pprint.rst:195
 msgid "Added the *underscore_numbers* parameter."
 msgstr "新增 *underscore_numbers* 參數。"
 
-#: ../../library/pprint.rst:177
+#: ../../library/pprint.rst:198
 msgid "No longer attempts to write to :data:`!sys.stdout` if it is ``None``."
 msgstr ""
 
-#: ../../library/pprint.rst:204
+#: ../../library/pprint.rst:202
 msgid ":class:`PrettyPrinter` instances have the following methods:"
 msgstr ""
 
-#: ../../library/pprint.rst:209
+#: ../../library/pprint.rst:207
 msgid ""
 "Return the formatted representation of *object*.  This takes into account "
 "the options passed to the :class:`PrettyPrinter` constructor."
 msgstr ""
 
-#: ../../library/pprint.rst:215
+#: ../../library/pprint.rst:213
 msgid ""
 "Print the formatted representation of *object* on the configured stream, "
 "followed by a newline."
 msgstr ""
 
-#: ../../library/pprint.rst:218
+#: ../../library/pprint.rst:216
 msgid ""
 "The following methods provide the implementations for the corresponding "
 "functions of the same names.  Using these methods on an instance is slightly "
 "more efficient since new :class:`PrettyPrinter` objects don't need to be "
 "created."
 msgstr ""
 
-#: ../../library/pprint.rst:228
+#: ../../library/pprint.rst:226
 msgid ""
 "Determine if the formatted representation of the object is \"readable,\" or "
 "can be used to reconstruct the value using :func:`eval`.  Note that this "
@@ -242,18 +222,18 @@ msgid ""
 "returns ``False``."
 msgstr ""
 
-#: ../../library/pprint.rst:237
+#: ../../library/pprint.rst:235
 msgid "Determine if the object requires a recursive representation."
 msgstr ""
 
-#: ../../library/pprint.rst:239
+#: ../../library/pprint.rst:237
 msgid ""
 "This method is provided as a hook to allow subclasses to modify the way "
 "objects are converted to strings.  The default implementation uses the "
 "internals of the :func:`saferepr` implementation."
 msgstr ""
 
-#: ../../library/pprint.rst:246
+#: ../../library/pprint.rst:244
 msgid ""
 "Returns three values: the formatted version of *object* as a string, a flag "
 "indicating whether the result is readable, and a flag indicating whether "
@@ -271,45 +251,45 @@ msgid ""
 "of the current call."
 msgstr ""
 
-#: ../../library/pprint.rst:264
+#: ../../library/pprint.rst:262
 msgid "Example"
 msgstr "範例"
 
-#: ../../library/pprint.rst:266
+#: ../../library/pprint.rst:264
 msgid ""
 "To demonstrate several uses of the :func:`~pprint.pp` function and its "
 "parameters, let's fetch information about a project from `PyPI <https://pypi."
 "org>`_::"
 msgstr ""
 
-#: ../../library/pprint.rst:275
+#: ../../library/pprint.rst:273
 msgid "In its basic form, :func:`~pprint.pp` shows the whole object::"
 msgstr ""
 
-#: ../../library/pprint.rst:331
+#: ../../library/pprint.rst:329
 msgid ""
 "The result can be limited to a certain *depth* (ellipsis is used for deeper "
 "contents)::"
 msgstr ""
 
-#: ../../library/pprint.rst:377
+#: ../../library/pprint.rst:375
 msgid ""
 "Additionally, maximum character *width* can be suggested. If a long object "
 "cannot be split, the specified width will be exceeded::"
 msgstr ""
 
-#: ../../library/pprint.rst:88 ../../library/pprint.rst:226
+#: ../../library/pprint.rst:121 ../../library/pprint.rst:224
 msgid "built-in function"
 msgstr "built-in function（內建函式）"
 
-#: ../../library/pprint.rst:88 ../../library/pprint.rst:226
+#: ../../library/pprint.rst:121 ../../library/pprint.rst:224
 msgid "eval"
 msgstr "eval"
 
-#: ../../library/pprint.rst:127
+#: ../../library/pprint.rst:155
 msgid "..."
 msgstr "..."
 
-#: ../../library/pprint.rst:127
+#: ../../library/pprint.rst:155
 msgid "placeholder"
 msgstr "placeholder（佔位符號）"
