summaryrefslogtreecommitdiffstats
path: root/Doc/library/logging.rst
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2011-11-23 08:54:22 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2011-11-23 08:54:22 (GMT)
commit287f24691dd8bda7f8acfebdda3201c738d67533 (patch)
tree732cc2117b7b13ff5c72dd79a1a1b5070cd6d6d5 /Doc/library/logging.rst
parent06403cff161e8cae35aa447f7c44cd326a8c0776 (diff)
downloadcpython-287f24691dd8bda7f8acfebdda3201c738d67533.zip
cpython-287f24691dd8bda7f8acfebdda3201c738d67533.tar.gz
cpython-287f24691dd8bda7f8acfebdda3201c738d67533.tar.bz2
Closes #13459: Clarified documentation on Logger.propagate. Thanks to Mike Fogel for the patch.
Diffstat (limited to 'Doc/library/logging.rst')
-rw-r--r--Doc/library/logging.rst12
1 files changed, 9 insertions, 3 deletions
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 5d385c5..2d71552 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -57,9 +57,15 @@ instantiated directly, but always through the module-level function
.. attribute:: Logger.propagate
- If this evaluates to false, logging messages are not passed by this logger or by
- its child loggers to the handlers of higher level (ancestor) loggers. The
- constructor sets this attribute to 1.
+ If this evaluates to true, logging messages are passed by this logger and by
+ its child loggers to the handlers of higher level (ancestor) loggers.
+ Messages are passed directly to the ancestor loggers' handlers - neither the
+ level nor filters of the ancestor loggers in question are considered.
+
+ If this evaluates to false, logging messages are not passed to the handlers
+ of ancestor loggers.
+
+ The constructor sets this attribute to 1.
.. method:: Logger.setLevel(lvl)