From: Vinay Sajip Date: Wed, 23 Nov 2011 08:51:35 +0000 (+0000) Subject: Closes #13459: Clarified documentation on Logger.propagate. Thanks to Mike Fogel... X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=3639807a79ea912f0178648861d08f8e5af5a03f;p=python Closes #13459: Clarified documentation on Logger.propagate. Thanks to Mike Fogel for the patch. --- diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index b666573ca5..5f6aa7e2fc 100644 --- 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)