[Python-checkins] python/dist/src/Doc/lib liblogging.tex,1.3,1.4

nnorwitz@users.sourceforge.net nnorwitz@users.sourceforge.net
Sat, 25 Jan 2003 13:29:44 -0800


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

Modified Files:
	liblogging.tex 
Log Message:
SF #638299, LaTeX documentation for logging package

Replace existing doc with new version from Vinay.
Fixed markup and wrapped long lines from patch.
Needs review.


Index: liblogging.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/liblogging.tex,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** liblogging.tex	25 Nov 2002 16:01:08 -0000	1.3
--- liblogging.tex	25 Jan 2003 21:29:41 -0000	1.4
***************
*** 7,1139 ****
  
  \moduleauthor{Vinay Sajip}{vinay_sajip@red-dove.com}
! \sectionauthor{Skip Montanaro}{skip@pobox.com}
  
  \modulesynopsis{Logging module for Python based on PEP 282.}
  
  
! There is a need for a standard logging system in Python, as documented in
! {}\pep{282} and enthusiastically endorsed by Guido van Rossum in the
! {}\citetitle[http://www.python.org/doc/essays/pepparade.html]{Parade of the
[...2199 lines suppressed...]
! level=NOTSET
! formatter=form09
! args=('localhost:9022', '/log', 'GET')
  \end{verbatim}
  
! Sections which specify formatter configuration are typified by the following.
  
  \begin{verbatim}
! [formatter_form01]
! format=F1 %(asctime)s %(levelname)s %(message)s
! datefmt=
  \end{verbatim}
+ 
+ The \code{format} entry is the overall format string, and the
+ \code{datefmt} entry is the \function{strftime()}-compatible date/time format
+ string. If empty, the package substitutes ISO8601 format date/times, which
+ is almost equivalent to specifying the date format string "%Y-%m-%d %H:%M:%S".
+ The ISO8601 format also specifies milliseconds, which are appended to the
+ result of using the above format string, with a comma separator. An example
+ time in ISO8601 format is \code{2003-01-23 00:29:50,411}.