mirrors/cpython
0
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2024-12-28 11:14:26 +08:00
Code Issues Packages Projects Releases Wiki Activity

bpo-30862: Updated Logger.setLevel documentation. (GH-2604)

Browse Source
This commit is contained in:
Vinay Sajip 2017-07-06 17:51:28 +01:00 committed by GitHub
parent b4baacee1a
commit 0653fba51c
1 changed files with 8 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
Doc/library/logging.rst
View File

@ -94,10 +94,14 @@ is the module's name in the Python package namespace.
.. method:: Logger.setLevel(lvl)
Sets the threshold for this logger to *lvl*. Logging messages which are less
severe than *lvl* will be ignored. When a logger is created, the level is set to
:const:`NOTSET` (which causes all messages 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 :const:`WARNING`.
severe than *lvl* will be ignored; logging messages which have severity *lvl*
or higher will be emitted by whichever handler or handlers service this logger,
unless a handler's level has been set to a higher severity level than *lvl*.
When a logger is created, the level is set to :const:`NOTSET` (which causes
all messages 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 :const:`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