Issue #24060: Made logging.Formatter documentation a little clearer.

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 5e21474812cba8f52a92e20da38922bda2cbbb7e..9f778f58ec44b6fcd70a2a982d1a7daa00a419e9 100644 (file)
--- 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