From: Vinay Sajip Date: Wed, 23 Nov 2011 08:54:22 +0000 (+0000) Subject: Closes #13459: Clarified documentation on Logger.propagate. Thanks to Mike Fogel... X-Git-Tag: v3.2.3rc1~363 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=287f24691dd8bda7f8acfebdda3201c738d67533;p=thirdparty%2FPython%2Fcpython.git 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 5d385c59689d..2d7155210b5c 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)