Mailing List Archive

bpo-35821: Fix restructuredtext code formatting in logging.rst (GH-29963)
https://github.com/python/cpython/commit/c7e7a4b969b5728d4b4f3c59bf98e1e830d5c6d6
commit: c7e7a4b969b5728d4b4f3c59bf98e1e830d5c6d6
branch: main
author: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
committer: Fidget-Spinner <28750310+Fidget-Spinner@users.noreply.github.com>
date: 2021-12-07T23:25:13+08:00
summary:

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

files:
M Doc/library/logging.rst

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index e7c64e5ba4036..ea6494f219ae7 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
bpo-35821: Fix restructuredtext code formatting in logging.rst (GH-29963) [ In reply to ]
https://github.com/python/cpython/commit/db42809d299d1bc3a07b29fabe8f74fa02a7e59e
commit: db42809d299d1bc3a07b29fabe8f74fa02a7e59e
branch: 3.9
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:48:32-08:00
summary:

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

(cherry picked from commit c7e7a4b969b5728d4b4f3c59bf98e1e830d5c6d6)

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

files:
M Doc/library/logging.rst

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 705b31d604500..9d6167cca5294 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