[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