[Python-checkins] python/dist/src/Doc/lib liblogging.tex, 1.33.2.5, 1.33.2.6

[vsajip@users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv30582

Modified Files:
      Tag: release24-maint
	liblogging.tex 
Log Message:
Minor clarification of effective level calculation

Index: liblogging.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/liblogging.tex,v
retrieving revision 1.33.2.5
retrieving revision 1.33.2.6
diff -u -d -r1.33.2.5 -r1.33.2.6
--- liblogging.tex	16 Sep 2005 10:55:57 -0000	1.33.2.5
+++ liblogging.tex	30 Sep 2005 12:08:25 -0000	1.33.2.6
@@ -334,6 +334,20 @@
 to be processed when the logger is the root logger, or delegation to the
 parent when the logger is a non-root logger). Note that the root logger
 is created with level \constant{WARNING}.
+
+The term "delegation to the parent" means that if a logger has a level
+of NOTSET, its chain of ancestor loggers is traversed until either an
+ancestor with a level other than NOTSET is found, or the root is
+reached.
+
+If an ancestor is found with a level other than NOTSET, then that
+ancestor's level is treated as the effective level of the logger where
+the ancestor search began, and is used to determine how a logging
+event is handled.
+
+If the root is reached, and it has a level of NOTSET, then all
+messages will be processed. Otherwise, the root's level will be used
+as the effective level.
 \end{methoddesc}
 
 \begin{methoddesc}{isEnabledFor}{lvl}