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}