[ python-Bugs-1074693 ] Errors and omissions in logging module documentation

[SourceForge.net]

Bugs item #1074693, was opened at 2004-11-28 16:09
Message generated for change (Comment added) made by vsajip
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1074693&group_id=5470

Category: Documentation
Group: None
>Status: Closed
>Resolution: Fixed
Priority: 5
Submitted By: Joachim Boomberschloss (boomberschloss)
Assigned to: Vinay Sajip (vsajip)
Summary: Errors and omissions in logging module documentation

Initial Comment:
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.


----------------------------------------------------------------------

>Comment By: Vinay Sajip (vsajip)
Date: 2004-12-02 21:29

Message:
Logged In: YES 
user_id=308438

Fixed in CVS.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1074693&group_id=5470