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

[SourceForge.net]

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

Category: Documentation
Group: None
Status: Open
Resolution: None
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.


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

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