From 287f24691dd8bda7f8acfebdda3201c738d67533 Mon Sep 17 00:00:00 2001 From: Vinay Sajip Date: Wed, 23 Nov 2011 08:54:22 +0000 Subject: [PATCH] Closes #13459: Clarified documentation on Logger.propagate. Thanks to Mike Fogel for the patch. --- Doc/library/logging.rst | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 5d385c59689..2d7155210b5 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)