]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
Documentation clarified to mention optional parameters.
authorVinay Sajip <vinay_sajip@yahoo.co.uk>
Tue, 3 Oct 2006 18:20:26 +0000 (18:20 +0000)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>
Tue, 3 Oct 2006 18:20:26 +0000 (18:20 +0000)
Doc/lib/liblogging.tex

index 1c0c47c987b837f684886a32001cab19e25110bd..e7756e673edc2dd03d20d077c965cb49d61dbf27 100644 (file)
@@ -528,8 +528,8 @@ as those created locally. Logger-level filtering is applied using
 \method{filter()}.
 \end{methoddesc}
 
-\begin{methoddesc}{makeRecord}{name, lvl, fn, lno, msg, args, exc_info,
-                               func, extra}
+\begin{methoddesc}{makeRecord}{name, lvl, fn, lno, msg, args, exc_info
+                               \optional{, func, extra}}
 This is a factory method which can be overridden in subclasses to create
 specialized \class{LogRecord} instances.
 \versionchanged[\var{func} and \var{extra} were added]{2.5}
@@ -1479,7 +1479,7 @@ source line where the logging call was made, and any exception
 information to be logged.
 
 \begin{classdesc}{LogRecord}{name, lvl, pathname, lineno, msg, args,
-                             exc_info, func}
+                             exc_info \optional{, func}}
 Returns an instance of \class{LogRecord} initialized with interesting
 information. The \var{name} is the logger name; \var{lvl} is the
 numeric level; \var{pathname} is the absolute pathname of the source
@@ -1490,7 +1490,7 @@ which, together with \var{msg}, makes up the user message; and
 \var{exc_info} is the exception tuple obtained by calling
 \function{sys.exc_info() }(or \constant{None}, if no exception information
 is available). The \var{func} is the name of the function from which the
-logging call was made.
+logging call was made. If not specified, it defaults to \var{None}.
 \versionchanged[\var{func} was added]{2.5}
 \end{classdesc}