From 68099ae7e081ce676bff544e0c2465f098b922eb Mon Sep 17 00:00:00 2001 From: Vinay Sajip Date: Sat, 2 May 2015 09:42:24 +0100 Subject: [PATCH] Issue #24060: Made logging.Formatter documentation a little clearer. --- Doc/library/logging.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) 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 -- 2.47.3