diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 8bdea1038c2b..10772b488376 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -735,7 +735,11 @@ functions. Provides an overriding level *lvl* for all loggers which takes precedence over the logger's own level. When the need arises to temporarily throttle logging - output down across the whole application, this function can be useful. + output down across the whole application, this function can be useful. Its + effect is to disable all logging calls of severity *lvl* and below, so that + if you call it with a value of INFO, then all INFO and DEBUG events would be + discarded, whereas those of severity WARNING and above would be processed + according to the logger's effective level. .. function:: addLevelName(lvl, levelName) diff --git a/Lib/logging/__init__.py b/Lib/logging/__init__.py index 7d70b4ae5faa..b1810d68e537 100644 --- a/Lib/logging/__init__.py +++ b/Lib/logging/__init__.py @@ -1557,7 +1557,7 @@ def log(level, msg, *args, **kwargs): def disable(level): """ - Disable all logging calls less severe than 'level'. + Disable all logging calls of severity 'level' and below. """ root.manager.disable = level