Update of /cvsroot/python/python/dist/src/Doc/lib In directory sc8-pr-cvs1:/tmp/cvs-serv18265 Modified Files: Tag: release23-maint liblogging.tex Log Message: backport [Bug #812936] Correct the documentation for RotatingFileHandler. Index: liblogging.tex =================================================================== RCS file: /cvsroot/python/python/dist/src/Doc/lib/liblogging.tex,v retrieving revision 1.12.8.1 retrieving revision 1.12.8.2 diff -C2 -d -r1.12.8.1 -r1.12.8.2 *** liblogging.tex 1 Sep 2003 22:52:14 -0000 1.12.8.1 --- liblogging.tex 26 Sep 2003 16:46:22 -0000 1.12.8.2 *************** *** 500,516 **** specified file is opened and used as the stream for logging. If \var{mode} is not specified, \code{'a'} is used. By default, the ! file grows indefinitely. You can use the \var{maxBytes} and \var{backupCount} values to allow the file to \dfn{rollover} at a predetermined size. When the size is about to be exceeded, the file is ! closed and a new file opened for output, transparently to the ! caller. Rollover occurs whenever the current log file is nearly ! \var{maxBytes} in length. If \var{backupCount} is >= 1, the system ! will successively create new files with the same pathname as the base ! file, but with extensions ".1", ".2" etc. appended to it. For example, ! with a backupCount of 5 and a base file name of "app.log", you would ! get "app.log", "app.log.1", "app.log.2", ... through to ! "app.log.5". When the last file reaches its size limit, the logging ! reverts to "app.log" which is truncated to zero length. If ! \var{maxBytes} is zero, rollover never occurs. \end{classdesc} --- 500,520 ---- specified file is opened and used as the stream for logging. If \var{mode} is not specified, \code{'a'} is used. By default, the ! file grows indefinitely. ! ! You can use the \var{maxBytes} and \var{backupCount} values to allow the file to \dfn{rollover} at a predetermined size. When the size is about to be exceeded, the file is ! closed and a new file is silently opened for output. Rollover occurs ! whenever the current log file is nearly \var{maxBytes} in length; if ! \var{maxBytes} is zero, rollover never occurs. If \var{backupCount} ! is non-zero, the system will save old log files by appending the ! extensions ".1", ".2" etc., to the filename. For example, with ! a \var{backupCount} of 5 and a base file name of ! \file{app.log}, you would get \file{app.log}, ! \file{app.log.1}, \file{app.log.2}, up to \file{app.log.5}. The file being ! written to is always \file{app.log}. When this file is filled, it is ! closed and renamed to \file{app.log.1}, and if files \file{app.log.1}, ! \file{app.log.2}, etc. exist, then they are renamed to \file{app.log.2}, ! \file{app.log.3} etc. respectively. \end{classdesc}