[Python-checkins] python/dist/src/Doc/lib liblogging.tex,1.7,1.8

[nnorwitz@users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1:/tmp/cvs-serv12493/Doc/lib

Modified Files:
	liblogging.tex 
Log Message:
SF patch #687683, Patches to logging (updates from Vinay)

Mostly rename WARN -> WARNING
Other misc tweaks
Update tests (not in original patch)


Index: liblogging.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/liblogging.tex,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -d -r1.7 -r1.8
*** liblogging.tex	28 Jan 2003 22:09:16 -0000	1.7
--- liblogging.tex	18 Feb 2003 14:20:05 -0000	1.8
***************
*** 251,256 ****
  Sets the threshold for this logger to \var{lvl}. Logging messages
  which are less severe than \var{lvl} will be ignored. When a logger is
! created, the level is set to \constant{ALL} (which causes all messages
! to be processed).
  \end{methoddesc}
  
--- 251,257 ----
  Sets the threshold for this logger to \var{lvl}. Logging messages
  which are less severe than \var{lvl} will be ignored. When a logger is
! created, the level is set to \constant{NOTSET} (which causes all messages
! to be processed in the root logger, or delegation to the parent in non-root
! loggers).
  \end{methoddesc}
  
***************
*** 264,270 ****
  \begin{methoddesc}{getEffectiveLevel}{}
  Indicates the effective level for this logger. If a value other than
! \constant{ALL} has been set using \method{setLevel()}, it is returned.
  Otherwise, the hierarchy is traversed towards the root until a value
! other than \constant{ALL} is found, and that value is returned.
  \end{methoddesc}
  
--- 265,271 ----
  \begin{methoddesc}{getEffectiveLevel}{}
  Indicates the effective level for this logger. If a value other than
! \constant{NOTSET} has been set using \method{setLevel()}, it is returned.
  Otherwise, the hierarchy is traversed towards the root until a value
! other than \constant{NOTSET} is found,and that value is returned.
  \end{methoddesc}
  
***************
*** 356,360 ****
  method in subclasses needs to call \method{Handler.__init__()}.
  
! \begin{methoddesc}{__init__}{level=\constant{ALL}}
  Initializes the \class{Handler} instance by setting its level, setting
  the list of filters to the empty list and creating a lock (using
--- 357,361 ----
  method in subclasses needs to call \method{Handler.__init__()}.
  
! \begin{methoddesc}{__init__}{level=\constant{NOTSET}}
  Initializes the \class{Handler} instance by setting its level, setting
  the list of filters to the empty list and creating a lock (using
***************
*** 378,382 ****
  Sets the threshold for this handler to \var{lvl}. Logging messages which are
  less severe than \var{lvl} will be ignored. When a handler is created, the
! level is set to \constant{ALL} (which causes all messages to be processed).
  \end{methoddesc}
  
--- 379,383 ----
  Sets the threshold for this handler to \var{lvl}. Logging messages which are
  less severe than \var{lvl} will be ignored. When a handler is created, the
! level is set to \constant{NOTSET} (which causes all messages to be processed).
  \end{methoddesc}
  
***************
*** 488,492 ****
  
  \begin{classdesc}{RotatingFileHandler}{filename\optional{, mode, maxBytes,
! 							 backupCount}}
  Returns a new instance of the \class{RotatingFileHandler} class. The
  specified file is opened and used as the stream for logging. If
--- 489,493 ----
  
  \begin{classdesc}{RotatingFileHandler}{filename\optional{, mode, maxBytes,
! 																			 backupCount}}
  Returns a new instance of the \class{RotatingFileHandler} class. The
  specified file is opened and used as the stream for logging. If
***************
*** 737,741 ****
  
  \begin{classdesc}{MemoryHandler}{capacity\optional{, flushLevel
! 				 \optional{, target}}}
  Returns a new instance of the \class{MemoryHandler} class. The
  instance is initialized with a buffer size of \var{capacity}. If
--- 738,742 ----
  
  \begin{classdesc}{MemoryHandler}{capacity\optional{, flushLevel
! \optional{, target}}}
  Returns a new instance of the \class{MemoryHandler} class. The
  instance is initialized with a buffer size of \var{capacity}. If
***************
*** 814,821 ****
                       (typically at application startup time)
  \%(thread)d          Thread ID (if available)
  \%(message)s         The result of msg \% args, computed just as the
                       record is emitted
  
- 
  \begin{classdesc}{Formatter}{\optional{fmt\optional{, datefmt}}}
  Returns a new instance of the \class{Formatter} class. The
--- 815,822 ----
                       (typically at application startup time)
  \%(thread)d          Thread ID (if available)
+ \%(process)d         Process ID (if available)
  \%(message)s         The result of msg \% args, computed just as the
                       record is emitted
  
  \begin{classdesc}{Formatter}{\optional{fmt\optional{, datefmt}}}
  Returns a new instance of the \class{Formatter} class. The
***************
*** 890,894 ****
  
  \begin{classdesc}{LogRecord}{name, lvl, pathname, lineno, msg, args,
! 			     exc_info}
  Returns an instance of \class{LogRecord} initialized with interesting
  information. The \var{name} is the logger name; \var{lvl} is the
--- 891,895 ----
  
  \begin{classdesc}{LogRecord}{name, lvl, pathname, lineno, msg, args,
! 														 exc_info}
  Returns an instance of \class{LogRecord} initialized with interesting
  information. The \var{name} is the logger name; \var{lvl} is the