[Python-checkins] python/dist/src/Doc/lib liblogging.tex,1.16,1.17

Fri Apr 9 14:26:43 EDT 2004

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv16853

Modified Files:
	liblogging.tex 
Log Message:
fix up some markup

Index: liblogging.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/liblogging.tex,v
retrieving revision 1.16
retrieving revision 1.17
diff -C2 -d -r1.16 -r1.17
*** liblogging.tex	8 Apr 2004 19:44:31 -0000	1.16
--- liblogging.tex	9 Apr 2004 18:26:40 -0000	1.17
***************
*** 56,60 ****
  developers). Handlers are passed \class{LogRecord} instances intended for
  particular destinations. Each logger can have zero, one or more handlers
! associated with it (via the \method{addHandler} method of \class{Logger}).
  In addition to any handlers directly associated with a logger,
  \emph{all handlers associated with all ancestors of the logger} are
--- 56,60 ----
  developers). Handlers are passed \class{LogRecord} instances intended for
  particular destinations. Each logger can have zero, one or more handlers
! associated with it (via the \method{addHandler()} method of \class{Logger}).
  In addition to any handlers directly associated with a logger,
  \emph{all handlers associated with all ancestors of the logger} are
***************
*** 557,562 ****
  binary format. If there is an error with the socket, silently drops the
  packet. If the connection was previously lost, re-establishes the connection.
! To unpickle the record at the receiving end into a LogRecord, use the
! \function{makeLogRecord} function.
  \end{methoddesc}

--- 557,562 ----
  binary format. If there is an error with the socket, silently drops the
  packet. If the connection was previously lost, re-establishes the connection.
! To unpickle the record at the receiving end into a \class{LogRecord}, use the
! \function{makeLogRecord()} function.
  \end{methoddesc}

***************
*** 598,603 ****
  binary format. If there is an error with the socket, silently drops the
  packet.
! To unpickle the record at the receiving end into a LogRecord, use the
! \function{makeLogRecord} function.
  \end{methoddesc}

--- 598,603 ----
  binary format. If there is an error with the socket, silently drops the
  packet.
! To unpickle the record at the receiving end into a \class{LogRecord}, use the
! \function{makeLogRecord()} function.
  \end{methoddesc}

***************
*** 814,823 ****
  knowledge of the \class{LogRecord} attributes - such as the default value
  mentioned above making use of the fact that the user's message and
! arguments are pre-formatted into a LogRecord's \var{message}
  attribute.  This format string contains standard python \%-style
  mapping keys. See section \ref{typesseq-strings}, ``String Formatting
  Operations,'' for more information on string formatting.

! Currently, the useful mapping keys in a LogRecord are:

  \begin{tableii}{l|l}{code}{Format}{Description}
--- 814,823 ----
  knowledge of the \class{LogRecord} attributes - such as the default value
  mentioned above making use of the fact that the user's message and
! arguments are pre-formatted into a \class{LogRecord}'s \var{message}
  attribute.  This format string contains standard python \%-style
  mapping keys. See section \ref{typesseq-strings}, ``String Formatting
  Operations,'' for more information on string formatting.

! Currently, the useful mapping keys in a \class{LogRecord} are:

  \begin{tableii}{l|l}{code}{Format}{Description}
***************
*** 837,844 ****
  \lineii{\%(lineno)d}   {Source line number where the logging call was issued
                          (if available).}
! \lineii{\%(created)f}  {Time when the LogRecord was created (as
                          returned by \function{time.time()}).}
! \lineii{\%(asctime)s}  {Human-readable time when the LogRecord was created.
!                         By default this is of the form
                          ``2003-07-08 16:49:45,896'' (the numbers after the
                          comma are millisecond portion of the time).}
--- 837,844 ----
  \lineii{\%(lineno)d}   {Source line number where the logging call was issued
                          (if available).}
! \lineii{\%(created)f}  {Time when the \class{LogRecord} was created (as
                          returned by \function{time.time()}).}
! \lineii{\%(asctime)s}  {Human-readable time when the \class{LogRecord}
!                         was created.  By default this is of the form
                          ``2003-07-08 16:49:45,896'' (the numbers after the
                          comma are millisecond portion of the time).}
***************
*** 909,913 ****
  \subsection{LogRecord Objects}

! LogRecord instances are created every time something is logged. They
  contain all the information pertinent to the event being logged. The
  main information passed in is in msg and args, which are combined
--- 909,913 ----
  \subsection{LogRecord Objects}

! \class{LogRecord} instances are created every time something is logged. They
  contain all the information pertinent to the event being logged. The
  main information passed in is in msg and args, which are combined
***************
*** 917,923 ****
  information to be logged.

! LogRecord has no methods; it's just a repository for information about the
! logging event. The only reason it's a class rather than a dictionary is to
! facilitate extension.

  \begin{classdesc}{LogRecord}{name, lvl, pathname, lineno, msg, args,
--- 917,923 ----
  information to be logged.

! \class{LogRecord} has no methods; it's just a repository for
! information about the logging event. The only reason it's a class
! rather than a dictionary is to facilitate extension.

  \begin{classdesc}{LogRecord}{name, lvl, pathname, lineno, msg, args,
***************
*** 984,988 ****
                 \label{logging-config-fileformat}}

! The configuration file format understood by \function{fileConfig} is
  based on ConfigParser functionality. The file must contain sections
  called \code{[loggers]}, \code{[handlers]} and \code{[formatters]}
--- 984,988 ----
                 \label{logging-config-fileformat}}

! The configuration file format understood by \function{fileConfig()} is
  based on ConfigParser functionality. The file must contain sections
  called \code{[loggers]}, \code{[handlers]} and \code{[formatters]}
***************
*** 1181,1187 ****
  \end{verbatim}

! The info message was not written to the file - we called the \method{setLevel}
! method to say we only wanted \code{WARNING} or worse, so the info message is 
! discarded.

  The timestamp is of the form  
--- 1181,1187 ----
  \end{verbatim}

! The info message was not written to the file: we called the
! \method{setLevel()} method to say we only wanted \constant{WARNING} or
! worse, so the info message is discarded.

  The timestamp is of the form  