diff options
| author | Vinay Sajip <vinay_sajip@yahoo.co.uk> | 2011-11-23 08:54:22 (GMT) |
|---|---|---|
| committer | Vinay Sajip <vinay_sajip@yahoo.co.uk> | 2011-11-23 08:54:22 (GMT) |
| commit | 287f24691dd8bda7f8acfebdda3201c738d67533 (patch) | |
| tree | 732cc2117b7b13ff5c72dd79a1a1b5070cd6d6d5 /Doc/library/logging.rst | |
| parent | 06403cff161e8cae35aa447f7c44cd326a8c0776 (diff) | |
| download | cpython-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.rst | 12 |
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) |