[docs] Misleading wording in Python HOWTOs

Slava Novak chogorislava at gmail.com
Wed Mar 15 10:58:29 EDT 2017


Hi,

Misleading wording:
https://docs.python.org/2/howto/logging.html#logging-advanced-tutorial
Section ->Basic Logging Tutorial->When to use logging->
...
The default level is WARNING, which means that only events of this *level
and above* will be tracked, unless the logging package is configured to do
otherwise.
...

But based on the table before this sting:
Level     When it’s used
DEBUG          Detailed information, typically of interest only when
diagnosing problems.
INFO              Confirmation that things are working as expected.
WARNING      An indication that something unexpected happened, or
indicative of some problem in the near future (e.g. ‘disk space low’). The
software is still working as expected.
ERROR     Due to a more serious problem, the software has not been able to
perform some function.
CRITICAL        A serious error, indicating that the program itself may be
unable to continue running.

So according to statement, all above which are blue will be logged.
Which is not true.

With WARNING level it will log: WARNING, ERROR, CRITICAL.

As show in *A simple example* section in
https://docs.python.org/2/howto/logging.html#logging-advanced-tutorial

Does this make sense?
Or I didn't read it properly?

Sincerely,
-Slava
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170315/5c63cace/attachment.html>


More information about the docs mailing list