From: Vinay Sajip Date: Sat, 2 May 2015 08:46:05 +0000 (+0100) Subject: Issue #24060: Made logging.Formatter documentation a little clearer. X-Git-Tag: v3.5.0b1~271^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=bbd95a9361cfa8a97d94f6d598e84dfc5e17a1f6;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 96861a7b9e39..90fb9b06d1c9 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -481,7 +481,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