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

[SourceForge.net]

Bugs item #1061857, was opened at 2004-11-07 12:35
Message generated for change (Comment added) made by jlgijsbers
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: Closed
>Resolution: Fixed
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

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

>Comment By: Johannes Gijsbers (jlgijsbers)
Date: 2004-11-07 17:15

Message:
Logged In: YES 
user_id=469548

Fixed by applying patch 1061924.

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

Comment By: Rodrigo Dias Arruda Senra (rodsenra)
Date: 2004-11-07 15:39

Message:
Logged In: YES 
user_id=9057

All issues mentioned above should be corrected by patch 1061924,
that includes Patch 1061882 by slmm, and contemplates the
remaining issues.

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

Comment By: Johannes Gijsbers (jlgijsbers)
Date: 2004-11-07 15:19

Message:
Logged In: YES 
user_id=469548

Patch 1061882 has been applied.

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

Comment By: Jeroen Vloothuis (slmm)
Date: 2004-11-07 14:01

Message:
Logged In: YES 
user_id=387137

Patch 1061882 adds a section about the TimedRotatingFileHandler.

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

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