summaryrefslogtreecommitdiffstats
path: root/Doc/howto
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2022-05-23 19:45:03 (GMT)
committerGitHub <noreply@github.com>2022-05-23 19:45:03 (GMT)
commitcea65730a75c06a34d00ffb29704cc7ac1a56b4b (patch)
tree9a3b6f3cce5eb8a18a19e00e4b9df3040156e0d7 /Doc/howto
parentf0950585a3723fd674964733ae3ced9217cf9d21 (diff)
downloadcpython-cea65730a75c06a34d00ffb29704cc7ac1a56b4b.zip
cpython-cea65730a75c06a34d00ffb29704cc7ac1a56b4b.tar.gz
cpython-cea65730a75c06a34d00ffb29704cc7ac1a56b4b.tar.bz2
gh-92859: Doc: add info about logging.debug() calling basicConfig() (GH-93063) (GH-93151)
(cherry picked from commit 2176898308acafedf87a48d33f29645e79b9af86)
Diffstat (limited to 'Doc/howto')
-rw-r--r--Doc/howto/logging.rst9
1 files changed, 5 insertions, 4 deletions
diff --git a/Doc/howto/logging.rst b/Doc/howto/logging.rst
index 4d76c27..9340062 100644
--- a/Doc/howto/logging.rst
+++ b/Doc/howto/logging.rst
@@ -178,10 +178,11 @@ following example::
raise ValueError('Invalid log level: %s' % loglevel)
logging.basicConfig(level=numeric_level, ...)
-The call to :func:`basicConfig` should come *before* any calls to :func:`debug`,
-:func:`info` etc. As it's intended as a one-off simple configuration facility,
-only the first call will actually do anything: subsequent calls are effectively
-no-ops.
+The call to :func:`basicConfig` should come *before* any calls to
+:func:`debug`, :func:`info`, etc. Otherwise, those functions will call
+:func:`basicConfig` for you with the default options. As it's intended as a
+one-off simple configuration facility, only the first call will actually do
+anything: subsequent calls are effectively no-ops.
If you run the above script several times, the messages from successive runs
are appended to the file *example.log*. If you want each run to start afresh,