Mailing List Archive

[3.10] bpo-35821: Fix restructuredtext code formatting in logging.rst (GH-29963) (GH-29965)
https://github.com/python/cpython/commit/14f03ce6e8a33cc8b45f11c4d428193fc7c4a145
commit: 14f03ce6e8a33cc8b45f11c4d428193fc7c4a145
branch: 3.10
author: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
committer: miss-islington <31488909+miss-islington@users.noreply.github.com>
date: 2021-12-07T07:47:31-08:00
summary:

[3.10] bpo-35821: Fix restructuredtext code formatting in logging.rst (GH-29963) (GH-29965)



(cherry picked from commit c7e7a4b969b5728d4b4f3c59bf98e1e830d5c6d6)


Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>

Automerge-Triggered-By: GH:Fidget-Spinner

files:
M Doc/library/logging.rst

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index ade4a3c6b261e..74b1f69caec5c 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -81,12 +81,12 @@ is the module's name in the Python package namespace.
of ancestor loggers.

Spelling it out with an example: If the propagate attribute of the logger named
- `A.B.C` evaluates to true, any event logged to `A.B.C` via a method call such as
- `logging.getLogger('A.B.C').error(...)` will [.subject to passing that logger's
+ ``A.B.C`` evaluates to true, any event logged to ``A.B.C`` via a method call such as
+ ``logging.getLogger('A.B.C').error(...)`` will [subject to passing that logger's
level and filter settings] be passed in turn to any handlers attached to loggers
- named `A.B`, `A` and the root logger, after first being passed to any handlers
- attached to `A.B.C`. If any logger in the chain `A.B.C`, `A.B`, `A` has its
- `propagate` attribute set to false, then that is the last logger whose handlers
+ named ``A.B``, ``A`` and the root logger, after first being passed to any handlers
+ attached to ``A.B.C``. If any logger in the chain ``A.B.C``, ``A.B``, ``A`` has its
+ ``propagate`` attribute set to false, then that is the last logger whose handlers
are offered the event to handle, and propagation stops at that point.

The constructor sets this attribute to ``True``.

_______________________________________________
Python-checkins mailing list
Python-checkins@python.org
https://mail.python.org/mailman/listinfo/python-checkins