This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Errors and omissions in logging module documentation
Type: Stage:
Components: Documentation Versions:
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: vinay.sajip Nosy List: boomberschloss, vinay.sajip
Priority: normal Keywords:

Created on 2004-11-28 16:09 by boomberschloss, last changed 2022-04-11 14:56 by admin. This issue is now closed.

Messages (2)
msg23358 - (view) Author: Joachim Boomberschloss (boomberschloss) Date: 2004-11-28 16:09
Python version: 2.3.3

I found the following problems in the standard logging 
module's documentation:

1. It is not mentioned that subclasses of LogRecord 
need to have a getMessage method 
(http://docs.python.org/lib/node295.html). Instead it is 
stated that "LogRecord has no methods"!

2. Level values are not documented (which hinders the 
addition of new levels that need to have a certain 
relation to the severity of existing levels), nor is the 
fact that adding a level with the same numeric value as 
an existing one overrides it.

3. The documentation states that "When a logger is 
created, the level is set to NOTSET" 
(http://docs.python.org/lib/node281.html), where in 
fact it is WARNING.
msg23359 - (view) Author: Vinay Sajip (vinay.sajip) * (Python committer) Date: 2004-12-02 21:29
Logged In: YES 
user_id=308438

Fixed in CVS.
History
Date User Action Args
2022-04-11 14:56:08adminsetgithub: 41240
2004-11-28 16:09:58boomberschlosscreate