diff -r 6132f46c2ab0 Doc/library/logging.rst
--- a/Doc/library/logging.rst	Wed Nov 23 00:03:15 2011 +0100
+++ b/Doc/library/logging.rst	Tue Nov 22 17:14:49 2011 -0800
@@ -57,9 +57,15 @@
 
 .. 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 logger's handlers - neither the
+   level nor filters of the ancestor logger 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)