sync with cpython 193a24bb

github-actions[bot] · web-flow · commit 7b677e57649b · 2024-03-25T00:04:53.000Z
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-03-06 00:03+0000\n"
+"POT-Creation-Date: 2024-03-25 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-"
@@ -69,7 +69,7 @@ msgid ""
 "parameters."
 msgstr ""
 
-#: ../../library/pprint.rst:53
+#: ../../library/pprint.rst:64
 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 "
@@ -78,37 +78,43 @@ msgid ""
 "use within a scope)."
 msgstr ""
 
-#: ../../library/pprint.rst:59
+#: ../../library/pprint.rst:70
 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."
 msgstr ""
 
-#: ../../library/pprint.rst:78
+#: ../../library/pprint.rst:75
+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."
+msgstr ""
+
+#: ../../library/pprint.rst:81
 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."
 msgstr ""
 
-#: ../../library/pprint.rst:88
+#: ../../library/pprint.rst:91
 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:98
+#: ../../library/pprint.rst:101
 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:105
+#: ../../library/pprint.rst:108
 msgid ""
 "Return a string representation of *object*, protected against recursion in "
 "some common data structures, namely instances of :class:`dict`, :class:"
@@ -118,117 +124,117 @@ msgid ""
 "id=number>``.  The representation is not otherwise formatted."
 msgstr ""
 
-#: ../../library/pprint.rst:118
+#: ../../library/pprint.rst:121
 msgid "PrettyPrinter Objects"
 msgstr "PrettyPrinter 物件"
 
-#: ../../library/pprint.rst:120
+#: ../../library/pprint.rst:123
 msgid "This module defines one class:"
 msgstr ""
 
-#: ../../library/pprint.rst:130
+#: ../../library/pprint.rst:133
 msgid ""
 "Construct a :class:`PrettyPrinter` instance.  This constructor understands "
 "several keyword parameters."
 msgstr ""
 
-#: ../../library/pprint.rst:133
+#: ../../library/pprint.rst:136
 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:138
+#: ../../library/pprint.rst:141
 msgid ""
 "Other values configure the manner in which nesting of complex data "
 "structures is displayed."
 msgstr ""
 
-#: ../../library/pprint.rst:141
+#: ../../library/pprint.rst:144
 msgid ""
 "*indent* (default 1) specifies the amount of indentation added for each "
 "nesting level."
 msgstr ""
 
-#: ../../library/pprint.rst:144
+#: ../../library/pprint.rst:147
 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:149
+#: ../../library/pprint.rst:152
 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:153
+#: ../../library/pprint.rst:156
 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:159
+#: ../../library/pprint.rst:162
 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:162
+#: ../../library/pprint.rst:165
 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:166
+#: ../../library/pprint.rst:169
 msgid "Added the *compact* parameter."
 msgstr "新增 *compact* 參數。"
 
-#: ../../library/pprint.rst:169
+#: ../../library/pprint.rst:172
 msgid "Added the *sort_dicts* parameter."
 msgstr "新增 *sort_dicts* 參數。"
 
-#: ../../library/pprint.rst:172
+#: ../../library/pprint.rst:175
 msgid "Added the *underscore_numbers* parameter."
 msgstr "新增 *underscore_numbers* 參數。"
 
-#: ../../library/pprint.rst:175
+#: ../../library/pprint.rst:178
 msgid "No longer attempts to write to :data:`!sys.stdout` if it is ``None``."
 msgstr ""
 
-#: ../../library/pprint.rst:202
+#: ../../library/pprint.rst:205
 msgid ":class:`PrettyPrinter` instances have the following methods:"
 msgstr ""
 
-#: ../../library/pprint.rst:207
+#: ../../library/pprint.rst:210
 msgid ""
 "Return the formatted representation of *object*.  This takes into account "
 "the options passed to the :class:`PrettyPrinter` constructor."
 msgstr ""
 
-#: ../../library/pprint.rst:213
+#: ../../library/pprint.rst:216
 msgid ""
 "Print the formatted representation of *object* on the configured stream, "
 "followed by a newline."
 msgstr ""
 
-#: ../../library/pprint.rst:216
+#: ../../library/pprint.rst:219
 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:226
+#: ../../library/pprint.rst:229
 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 "
@@ -237,18 +243,18 @@ msgid ""
 "returns ``False``."
 msgstr ""
 
-#: ../../library/pprint.rst:235
+#: ../../library/pprint.rst:238
 msgid "Determine if the object requires a recursive representation."
 msgstr ""
 
-#: ../../library/pprint.rst:237
+#: ../../library/pprint.rst:240
 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:244
+#: ../../library/pprint.rst:247
 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 "
@@ -266,45 +272,45 @@ msgid ""
 "of the current call."
 msgstr ""
 
-#: ../../library/pprint.rst:262
+#: ../../library/pprint.rst:265
 msgid "Example"
 msgstr "範例"
 
-#: ../../library/pprint.rst:264
+#: ../../library/pprint.rst:267
 msgid ""
-"To demonstrate several uses of the :func:`~pprint.pprint` function and its "
+"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:273
-msgid "In its basic form, :func:`~pprint.pprint` shows the whole object::"
+#: ../../library/pprint.rst:276
+msgid "In its basic form, :func:`~pprint.pp` shows the whole object::"
 msgstr ""
 
-#: ../../library/pprint.rst:329
+#: ../../library/pprint.rst:332
 msgid ""
 "The result can be limited to a certain *depth* (ellipsis is used for deeper "
 "contents)::"
 msgstr ""
 
-#: ../../library/pprint.rst:375
+#: ../../library/pprint.rst:378
 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:86 ../../library/pprint.rst:224
+#: ../../library/pprint.rst:89 ../../library/pprint.rst:227
 msgid "built-in function"
 msgstr "built-in function（內建函式）"
 
-#: ../../library/pprint.rst:86 ../../library/pprint.rst:224
+#: ../../library/pprint.rst:89 ../../library/pprint.rst:227
 msgid "eval"
 msgstr "eval"
 
-#: ../../library/pprint.rst:125
+#: ../../library/pprint.rst:128
 msgid "..."
 msgstr "..."
 
-#: ../../library/pprint.rst:125
+#: ../../library/pprint.rst:128
 msgid "placeholder"
 msgstr "placeholder（佔位符號）"
