From: Gregory P. Smith <greg@krypto.org>
Date: Tue, 24 Mar 2020 16:48:32 +0000 (-0700)
Subject: Clarify a guarantee of the logging module. (GH-19132)
X-Git-Tag: v3.9.0a6~289
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9b8e74ca77da7167033917d155e5f55c67b92f14;p=thirdparty%2FPython%2Fcpython.git

Clarify a guarantee of the logging module. (GH-19132)

When no additional arguments are passed to logging.debug() and related
methods, no % operation is performed on the passed in message.
---

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 3b414ad30272..e943011c8afd 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -159,6 +159,7 @@ is the module's name in the Python package namespace.
       message format string, and the *args* are the arguments which are merged into
       *msg* using the string formatting operator. (Note that this means that you can
       use keywords in the format string, together with a single dictionary argument.)
+      No % formatting operation is performed on *msg* when no *args* are supplied.
 
       There are four keyword arguments in *kwargs* which are inspected:
       *exc_info*, *stack_info*, *stacklevel* and *extra*.