summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2004-04-09 18:26:40 (GMT)
committerFred Drake <fdrake@acm.org>2004-04-09 18:26:40 (GMT)
commit6b3b046ab0a0fae6ad50cbb0e1fe4b28f5f7f957 (patch)
tree010c993e7c96588d7990038ee430e7bcaec606ad /Doc
parent7dacda2947e1d339ce138c237474df009dcc64be (diff)
downloadcpython-6b3b046ab0a0fae6ad50cbb0e1fe4b28f5f7f957.zip
cpython-6b3b046ab0a0fae6ad50cbb0e1fe4b28f5f7f957.tar.gz
cpython-6b3b046ab0a0fae6ad50cbb0e1fe4b28f5f7f957.tar.bz2
fix up some markup
Diffstat (limited to 'Doc')
-rw-r--r--Doc/lib/liblogging.tex36
1 files changed, 18 insertions, 18 deletions
diff --git a/Doc/lib/liblogging.tex b/Doc/lib/liblogging.tex
index 13e2d6e..af46afb 100644
--- a/Doc/lib/liblogging.tex
+++ b/Doc/lib/liblogging.tex
@@ -55,7 +55,7 @@ location (or set of locations) which is useful for the target audience for
that message (such as end users, support desk staff, system administrators,
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}).
+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
called to dispatch the message.
@@ -556,8 +556,8 @@ Closes the socket.
Pickles the record's attribute dictionary and writes it to the socket in
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.
+To unpickle the record at the receiving end into a \class{LogRecord}, use the
+\function{makeLogRecord()} function.
\end{methoddesc}
\begin{methoddesc}{handleError}{}
@@ -597,8 +597,8 @@ and \var{port}.
Pickles the record's attribute dictionary and writes it to the socket in
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.
+To unpickle the record at the receiving end into a \class{LogRecord}, use the
+\function{makeLogRecord()} function.
\end{methoddesc}
\begin{methoddesc}{makeSocket}{}
@@ -813,12 +813,12 @@ supplied, the default value of \code{'\%(message)s\e'} is used.
A Formatter can be initialized with a format string which makes use of
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}
+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 LogRecord are:
+Currently, the useful mapping keys in a \class{LogRecord} are:
\begin{tableii}{l|l}{code}{Format}{Description}
\lineii{\%(name)s} {Name of the logger (logging channel).}
@@ -836,10 +836,10 @@ Currently, the useful mapping keys in a LogRecord are:
\lineii{\%(module)s} {Module (name portion of filename).}
\lineii{\%(lineno)d} {Source line number where the logging call was issued
(if available).}
-\lineii{\%(created)f} {Time when the LogRecord was created (as
+\lineii{\%(created)f} {Time when the \class{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
+\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).}
\lineii{\%(msecs)d} {Millisecond portion of the time when the
@@ -908,7 +908,7 @@ method.
\subsection{LogRecord Objects}
-LogRecord instances are created every time something is logged. They
+\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
using msg \% args to create the message field of the record. The record
@@ -916,9 +916,9 @@ also includes information such as when the record was created, the
source line where the logging call was made, and any exception
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.
+\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,
exc_info}
@@ -983,7 +983,7 @@ on the return value from \function{listen()}.
\subsubsection{Configuration file format%
\label{logging-config-fileformat}}
-The configuration file format understood by \function{fileConfig} is
+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]}
which identify by name the entities of each type which are defined in
@@ -1180,9 +1180,9 @@ If we look in the file that was created, we'll see something like this:
2003-07-08 16:49:45,896 ERROR We have a problem
\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 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
``year-month-day hour:minutes:seconds,milliseconds.''