diff options
author | Vinay Sajip <vinay_sajip@yahoo.co.uk> | 2010-08-19 19:17:41 (GMT) |
---|---|---|
committer | Vinay Sajip <vinay_sajip@yahoo.co.uk> | 2010-08-19 19:17:41 (GMT) |
commit | 3478ac066b1d5367b5f818df7aa65a1a16912755 (patch) | |
tree | 15c5dcd993f2d47b530baaefbbd4287353c15b5a /Doc | |
parent | 4f1ba0de8afe4a5055d7b3dd81a952fe17c226d6 (diff) | |
download | cpython-3478ac066b1d5367b5f818df7aa65a1a16912755.zip cpython-3478ac066b1d5367b5f818df7aa65a1a16912755.tar.gz cpython-3478ac066b1d5367b5f818df7aa65a1a16912755.tar.bz2 |
Issue #9606: Updated documentation for Filter objects.
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/library/logging.rst | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index b2f98d0..f257643 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -2558,6 +2558,13 @@ initialized with the empty string, all events are passed. yes. If deemed appropriate, the record may be modified in-place by this method. +Note that filters attached to handlers are consulted whenever an event is +emitted by the handler, whereas filters attached to loggers are consulted +whenever an event is logged to the handler (using :meth:`debug`, :meth:`info`, +etc.) This means that events which have been generated by descendant loggers +will not be filtered by a logger's filter setting, unless the filter has also +been applied to those descendant loggers. + .. _log-record: LogRecord Objects |