From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 24 Mar 2020 16:54:40 +0000 (-0700)
Subject: Clarify a guarantee of the logging module. (GH-19132)
X-Git-Tag: v3.8.3rc1~82
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8cd48b60fde147087dca061e836c1a47156ac612;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.
(cherry picked from commit 9b8e74ca77da7167033917d155e5f55c67b92f14)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
---

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 4da5778fa641..14e7190cbb0f 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*.