From 26f2e05f727840c65b42e1cb3aa0df649b258692 Mon Sep 17 00:00:00 2001 From: Vinay Sajip Date: Sat, 2 May 2015 09:46:05 +0100 Subject: Issue #24060: Made logging.Formatter documentation a little clearer. --- Doc/library/logging.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'Doc/library/logging.rst') diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 96861a7b9e..90fb9b06d1 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 -- cgit v1.2.1