[ python-Bugs-1061857 ] Error and omission in logging docs

[SourceForge.net]

Bugs item #1061857, was opened at 2004-11-07 11:35
Message generated for change (Tracker Item Submitted) made by Item Submitter
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1061857&group_id=5470

Category: Documentation
Group: Python 2.4
Status: Open
Resolution: None
Priority: 5
Submitted By: Kent Johnson (kjohnson)
Assigned to: Nobody/Anonymous (nobody)
Summary: Error and omission in logging docs

Initial Comment:
- logging.handlers.TimedRotatingFileHandler and
BaseRotatingFileHandler are not mentioned in the
logging module docs at all AFAICT.

- Library Reference section 6.29.5.3
RotatingFileHandler has an error. In the description of
emit(), it says, "catering for rollover as described in
setRollover()." There is no description of
setRollover(). It seems to be referring to text that is
part of the main entry for the class.

The page is so short, I think this could be reworded to
say, "catering for rollover as described above."

(I actually found the error while looking in the docs
for a timed rollover log, and I found
TimedRotatingFileHandler while looking in the source
for setRollover(). Kind of ironic :)

Kent

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

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