From 4f0f9f066e72255c88d4ec9e9f8e510903577713 Mon Sep 17 00:00:00 2001 From: =?utf8?q?David=20R=C3=B6thlisberger?= Date: Mon, 9 Sep 2019 12:29:54 +0100 Subject: [PATCH] logging.Formatter docs: Add missing `validate` parameter, clarify `style` parameter (GH-15222) --- Doc/library/logging.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index cc611fc870..dec27bff56 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -528,7 +528,7 @@ The useful mapping keys in a :class:`LogRecord` are given in the section on :ref:`logrecord-attributes`. -.. class:: Formatter(fmt=None, datefmt=None, style='%') +.. class:: Formatter(fmt=None, datefmt=None, style='%', validate=True) Returns a new instance of the :class:`Formatter` class. The instance is initialized with a format string for the message as a whole, as well as a @@ -538,8 +538,11 @@ The useful mapping keys in a :class:`LogRecord` are given in the section on The *style* parameter can be one of '%', '{' or '$' and determines how the format string will be merged with its data: using one of %-formatting, - :meth:`str.format` or :class:`string.Template`. See :ref:`formatting-styles` - for more information on using {- and $-formatting for log messages. + :meth:`str.format` or :class:`string.Template`. This only applies to the + format string *fmt* (e.g. ``'%(message)s'`` or ``{message}``), not to the + actual log messages passed to ``Logger.debug`` etc; see + :ref:`formatting-styles` for more information on using {- and $-formatting + for log messages. .. versionchanged:: 3.2 The *style* parameter was added. -- 2.40.0