sync with cpython cc5870a1

Author: github-actions[bot]

howto/logging.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-10-11 17:13+0000\n"
+"POT-Creation-Date: 2024-02-02 00:03+0000\n"
 "PO-Revision-Date: 2018-05-23 14:36+0000\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -711,10 +711,10 @@ msgstr ""
 msgid ""
 "The :meth:`~Handler.setLevel` method, just as in logger objects, specifies "
 "the lowest severity that will be dispatched to the appropriate destination.  "
-"Why are there two :func:`setLevel` methods?  The level set in the logger "
-"determines which severity of messages it will pass to its handlers.  The "
-"level set in each handler determines which messages that handler will send "
-"on."
+"Why are there two :meth:`~Handler.setLevel` methods?  The level set in the "
+"logger determines which severity of messages it will pass to its handlers.  "
+"The level set in each handler determines which messages that handler will "
+"send on."
 msgstr ""
 
 #: ../../howto/logging.rst:528
@@ -923,46 +923,40 @@ msgstr ""
 msgid ""
 "If no logging configuration is provided, it is possible to have a situation "
 "where a logging event needs to be output, but no handlers can be found to "
-"output the event. The behaviour of the logging package in these "
-"circumstances is dependent on the Python version."
+"output the event."
 msgstr ""
 
-#: ../../howto/logging.rst:781
+#: ../../howto/logging.rst:780
+msgid ""
+"The event is output using a 'handler of last resort', stored in :data:"
+"`lastResort`. This internal handler is not associated with any logger, and "
+"acts like a :class:`~logging.StreamHandler` which writes the event "
+"description message to the current value of ``sys.stderr`` (therefore "
+"respecting any redirections which may be in effect). No formatting is done "
+"on the message - just the bare event description message is printed. The "
+"handler's level is set to ``WARNING``, so all events at this and greater "
+"severities will be output."
+msgstr ""
+
+#: ../../howto/logging.rst:791
 msgid "For versions of Python prior to 3.2, the behaviour is as follows:"
 msgstr ""
 
-#: ../../howto/logging.rst:783
+#: ../../howto/logging.rst:793
 msgid ""
-"If *logging.raiseExceptions* is ``False`` (production mode), the event is "
+"If :data:`raiseExceptions` is ``False`` (production mode), the event is "
 "silently dropped."
 msgstr ""
 
-#: ../../howto/logging.rst:786
+#: ../../howto/logging.rst:796
 msgid ""
-"If *logging.raiseExceptions* is ``True`` (development mode), a message 'No "
+"If :data:`raiseExceptions` is ``True`` (development mode), a message 'No "
 "handlers could be found for logger X.Y.Z' is printed once."
 msgstr ""
 
-#: ../../howto/logging.rst:789
-msgid "In Python 3.2 and later, the behaviour is as follows:"
-msgstr ""
-
-#: ../../howto/logging.rst:791
-msgid ""
-"The event is output using a 'handler of last resort', stored in ``logging."
-"lastResort``. This internal handler is not associated with any logger, and "
-"acts like a :class:`~logging.StreamHandler` which writes the event "
-"description message to the current value of ``sys.stderr`` (therefore "
-"respecting any redirections which may be in effect). No formatting is done "
-"on the message - just the bare event description message is printed. The "
-"handler's level is set to ``WARNING``, so all events at this and greater "
-"severities will be output."
-msgstr ""
-
-#: ../../howto/logging.rst:800
+#: ../../howto/logging.rst:799
 msgid ""
-"To obtain the pre-3.2 behaviour, ``logging.lastResort`` can be set to "
-"``None``."
+"To obtain the pre-3.2 behaviour, :data:`lastResort` can be set to ``None``."
 msgstr ""
 
 #: ../../howto/logging.rst:805
@@ -1267,8 +1261,8 @@ msgstr ""
 
 #: ../../howto/logging.rst:1001
 msgid ""
-"For formatting multiple messages in a batch, instances of :class:`~handlers."
-"BufferingFormatter` can be used. In addition to the format string (which is "
+"For formatting multiple messages in a batch, instances of :class:"
+"`BufferingFormatter` can be used. In addition to the format string (which is "
 "applied to each message in the batch), there is provision for header and "
 "trailer format strings."
 msgstr ""
@@ -1318,19 +1312,19 @@ msgid ""
 "the exception is swallowed."
 msgstr ""
 
-#: ../../howto/logging.rst:1038
+#: ../../howto/logging.rst:1039
 msgid ""
 "The default value of :data:`raiseExceptions` is ``True``. This is because "
 "during development, you typically want to be notified of any exceptions that "
 "occur. It's advised that you set :data:`raiseExceptions` to ``False`` for "
 "production usage."
 msgstr ""
 
-#: ../../howto/logging.rst:1048
+#: ../../howto/logging.rst:1049
 msgid "Using arbitrary objects as messages"
 msgstr ""
 
-#: ../../howto/logging.rst:1050
+#: ../../howto/logging.rst:1051
 msgid ""
 "In the preceding sections and examples, it has been assumed that the message "
 "passed when logging the event is a string. However, this is not the only "
@@ -1342,11 +1336,11 @@ msgid ""
 "the wire."
 msgstr ""
 
-#: ../../howto/logging.rst:1061
+#: ../../howto/logging.rst:1062
 msgid "Optimization"
 msgstr ""
 
-#: ../../howto/logging.rst:1063
+#: ../../howto/logging.rst:1064
 msgid ""
 "Formatting of message arguments is deferred until it cannot be avoided. "
 "However, computing the arguments passed to the logging method can also be "
@@ -1357,13 +1351,13 @@ msgid ""
 "code like this::"
 msgstr ""
 
-#: ../../howto/logging.rst:1075
+#: ../../howto/logging.rst:1076
 msgid ""
-"so that if the logger's threshold is set above ``DEBUG``, the calls to :func:"
-"`expensive_func1` and :func:`expensive_func2` are never made."
+"so that if the logger's threshold is set above ``DEBUG``, the calls to "
+"``expensive_func1`` and ``expensive_func2`` are never made."
 msgstr ""
 
-#: ../../howto/logging.rst:1078
+#: ../../howto/logging.rst:1079
 msgid ""
 "In some cases, :meth:`~Logger.isEnabledFor` can itself be more expensive "
 "than you'd like (e.g. for deeply nested loggers where an explicit level is "
@@ -1375,102 +1369,102 @@ msgid ""
 "while the application is running (which is not all that common)."
 msgstr ""
 
-#: ../../howto/logging.rst:1087
+#: ../../howto/logging.rst:1088
 msgid ""
 "There are other optimizations which can be made for specific applications "
 "which need more precise control over what logging information is collected. "
 "Here's a list of things you can do to avoid processing during logging which "
 "you don't need:"
 msgstr ""
 
-#: ../../howto/logging.rst:1093
+#: ../../howto/logging.rst:1094
 msgid "What you don't want to collect"
 msgstr ""
 
-#: ../../howto/logging.rst:1093
+#: ../../howto/logging.rst:1094
 msgid "How to avoid collecting it"
 msgstr ""
 
-#: ../../howto/logging.rst:1095
+#: ../../howto/logging.rst:1096
 msgid "Information about where calls were made from."
 msgstr ""
 
-#: ../../howto/logging.rst:1095
+#: ../../howto/logging.rst:1096
 msgid ""
 "Set ``logging._srcfile`` to ``None``. This avoids calling :func:`sys."
 "_getframe`, which may help to speed up your code in environments like PyPy "
 "(which can't speed up code that uses :func:`sys._getframe`)."
 msgstr ""
 
-#: ../../howto/logging.rst:1101
+#: ../../howto/logging.rst:1102
 msgid "Threading information."
 msgstr ""
 
-#: ../../howto/logging.rst:1101
+#: ../../howto/logging.rst:1102
 msgid "Set ``logging.logThreads`` to ``False``."
 msgstr ""
 
-#: ../../howto/logging.rst:1103
+#: ../../howto/logging.rst:1104
 msgid "Current process ID (:func:`os.getpid`)"
 msgstr ""
 
-#: ../../howto/logging.rst:1103
+#: ../../howto/logging.rst:1104
 msgid "Set ``logging.logProcesses`` to ``False``."
 msgstr ""
 
-#: ../../howto/logging.rst:1105
+#: ../../howto/logging.rst:1106
 msgid ""
 "Current process name when using ``multiprocessing`` to manage multiple "
 "processes."
 msgstr ""
 
-#: ../../howto/logging.rst:1105
+#: ../../howto/logging.rst:1106
 msgid "Set ``logging.logMultiprocessing`` to ``False``."
 msgstr ""
 
-#: ../../howto/logging.rst:1108
+#: ../../howto/logging.rst:1109
 msgid "Current :class:`asyncio.Task` name when using ``asyncio``."
 msgstr ""
 
-#: ../../howto/logging.rst:1108
+#: ../../howto/logging.rst:1109
 msgid "Set ``logging.logAsyncioTasks`` to ``False``."
 msgstr ""
 
-#: ../../howto/logging.rst:1112
+#: ../../howto/logging.rst:1113
 msgid ""
 "Also note that the core logging module only includes the basic handlers. If "
 "you don't import :mod:`logging.handlers` and :mod:`logging.config`, they "
 "won't take up any memory."
 msgstr ""
 
-#: ../../howto/logging.rst:1119
+#: ../../howto/logging.rst:1120
 msgid "Other resources"
 msgstr ""
 
-#: ../../howto/logging.rst:1124
+#: ../../howto/logging.rst:1125
 msgid "Module :mod:`logging`"
 msgstr ":mod:`logging` 模組"
 
-#: ../../howto/logging.rst:1124
+#: ../../howto/logging.rst:1125
 msgid "API reference for the logging module."
 msgstr ""
 
-#: ../../howto/logging.rst:1127
+#: ../../howto/logging.rst:1128
 msgid "Module :mod:`logging.config`"
 msgstr ":mod:`logging.config` 模組"
 
-#: ../../howto/logging.rst:1127
+#: ../../howto/logging.rst:1128
 msgid "Configuration API for the logging module."
 msgstr ""
 
-#: ../../howto/logging.rst:1130
+#: ../../howto/logging.rst:1131
 msgid "Module :mod:`logging.handlers`"
 msgstr ":mod:`logging.handlers` 模組"
 
-#: ../../howto/logging.rst:1130
+#: ../../howto/logging.rst:1131
 msgid "Useful handlers included with the logging module."
 msgstr ""
 
-#: ../../howto/logging.rst:1132
+#: ../../howto/logging.rst:1133
 msgid ":ref:`A logging cookbook <logging-cookbook>`"
 msgstr ""