summaryrefslogtreecommitdiffstats
path: root/Doc/lib/liblogging.tex
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2004-12-02 21:27:42 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2004-12-02 21:27:42 (GMT)
commite8fdc4502f71ba230dd1320926796925065f662e (patch)
tree46c9607cefeda1992af9953333e43b6df4dcf351 /Doc/lib/liblogging.tex
parent58d89dba7d65997d3994f7e21ac5bc68534eacae (diff)
downloadcpython-e8fdc4502f71ba230dd1320926796925065f662e.zip
cpython-e8fdc4502f71ba230dd1320926796925065f662e.tar.gz
cpython-e8fdc4502f71ba230dd1320926796925065f662e.tar.bz2
Fixed errors reported in SF bug #1074693
Diffstat (limited to 'Doc/lib/liblogging.tex')
-rw-r--r--Doc/lib/liblogging.tex29
1 files changed, 23 insertions, 6 deletions
diff --git a/Doc/lib/liblogging.tex b/Doc/lib/liblogging.tex
index 6360a9a..4e85963 100644
--- a/Doc/lib/liblogging.tex
+++ b/Doc/lib/liblogging.tex
@@ -35,6 +35,21 @@ constrained to use these levels: you can specify your own and use a
more general \class{Logger} method, \method{log()}, which takes an
explicit level argument.
+The numeric values of logging levels are given in the following table. These
+are primarily of interest if you want to define your own levels, and need
+them to have specific values relative to the predefined levels. If you
+define a level with the same numeric value, it overwrites the predefined
+value; the predefined name is lost.
+
+\begin{tableii}{l|l}{code}{Level}{Numeric value}
+ \lineii{CRITICAL}{50}
+ \lineii{ERROR}{40}
+ \lineii{WARNING}{30}
+ \lineii{INFO}{20}
+ \lineii{DEBUG}{10}
+ \lineii{NOTSET}{0}
+\end{tableii}
+
Levels can also be associated with loggers, being set either by the
developer or through loading a saved logging configuration. When a
logging method is called on a logger, the logger compares its own
@@ -297,8 +312,9 @@ constructor sets this attribute to 1.
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).
+to be processed when the logger is the root logger, or delegation to the
+parent when the logger is a non-root logger). Note that the root logger
+is created with level \constant{WARNING}.
\end{methoddesc}
\begin{methoddesc}{isEnabledFor}{lvl}
@@ -1324,10 +1340,6 @@ 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.
-\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}
Returns an instance of \class{LogRecord} initialized with interesting
@@ -1342,6 +1354,11 @@ which, together with \var{msg}, makes up the user message; and
is available).
\end{classdesc}
+\begin{methoddesc}{getMessage}{}
+Returns the message for this \class{LogRecord} instance after merging any
+user-supplied arguments with the message.
+\end{methoddesc}
+
\subsection{Thread Safety}
The logging module is intended to be thread-safe without any special work