From bbd95a9361cfa8a97d94f6d598e84dfc5e17a1f6 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(-) diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 96861a7..90fb9b0 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 v0.12