Closes #13459: Clarified documentation on Logger.propagate. Thanks to Mike Fogel...

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index b666573ca540800704421f23a9ca7e55a7a3a6b9..5f6aa7e2fcc9665da231f73f900073e2575d76fa 100644 (file)
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -59,9 +59,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)