From: Vinay Sajip Date: Sat, 2 May 2015 08:42:24 +0000 (+0100) Subject: Issue #24060: Made logging.Formatter documentation a little clearer. X-Git-Tag: v2.7.10rc1~16 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=68099ae7e081ce676bff544e0c2465f098b922eb;p=thirdparty%2FPython%2Fcpython.git Issue #24060: Made logging.Formatter documentation a little clearer. --- diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 5e21474812cb..9f778f58ec44 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -440,7 +440,9 @@ Formatter Objects responsible for converting a :class:`LogRecord` to (usually) a string which can be interpreted by either a human or an external system. The base :class:`Formatter` allows a formatting string to be specified. If none is -supplied, the default value of ``'%(message)s'`` is used. +supplied, the default value of ``'%(message)s'`` is used, which just includes +the message in the logging call. To have additional items of information in the +formatted output (such as a timestamp), keep reading. 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