[docs] [issue19789] Improve wording of how to "undo" a call to logging.disable(lvl)

[Vinay Sajip]

Vinay Sajip added the comment:

It's not the docstring in the code, it's the actual documentation. I propose to change it so that the documentation for disable will read:

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. 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. If ``logging.disable(logging.NOTSET)`` is called, it effectively removes this overriding level, so that logging output again depends on the effective levels of individual loggers.

Please confirm if this is still not clear enough, otherwise I will commit this in a day or two and close the issue.

----------
versions: +Python 2.7, Python 3.3, Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19789>
_______________________________________