Issue #9606: Updated documentation for Filter objects.

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index b2f98d037386b11a91fdec7b84df2ee50b7684dc..f257643b72702c1b8a8cec0ab3538492003239bc 100644 (file)
--- 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