summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorswatantra <swatantra.kumar8@gmail.com>2019-06-10 00:58:30 +0530
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2019-06-10 13:38:49 +0200
commit03cd3d137e2c29484b020b9768a4741f1096be97 (patch)
tree57a3c0fcaf2101d81d08fa8ecdb677225fa86c62 /docs
parent3ee0834a4652fb9eb8b69e09c3541901739021de (diff)
Fixed #30553 -- Clarified the default value of disable_existing_loggers.
Diffstat (limited to 'docs')
-rw-r--r--docs/topics/logging.txt18
1 files changed, 9 insertions, 9 deletions
diff --git a/docs/topics/logging.txt b/docs/topics/logging.txt
index d1aa8a3ea9..0820451709 100644
--- a/docs/topics/logging.txt
+++ b/docs/topics/logging.txt
@@ -218,15 +218,15 @@ default logging configuration <default-logging-configuration>` using the
following scheme.
If the ``disable_existing_loggers`` key in the :setting:`LOGGING` dictConfig is
-set to ``True`` (which is the default) then all loggers from the default
-configuration will be disabled. Disabled loggers are not the same as removed;
-the logger will still exist, but will silently discard anything logged to it,
-not even propagating entries to a parent logger. Thus you should be very
-careful using ``'disable_existing_loggers': True``; it's probably not what you
-want. Instead, you can set ``disable_existing_loggers`` to ``False`` and
-redefine some or all of the default loggers; or you can set
-:setting:`LOGGING_CONFIG` to ``None`` and :ref:`handle logging config yourself
-<disabling-logging-configuration>`.
+set to ``True`` (which is the ``dictConfig`` default if the key is missing)
+then all loggers from the default configuration will be disabled. Disabled
+loggers are not the same as removed; the logger will still exist, but will
+silently discard anything logged to it, not even propagating entries to a
+parent logger. Thus you should be very careful using
+``'disable_existing_loggers': True``; it's probably not what you want. Instead,
+you can set ``disable_existing_loggers`` to ``False`` and redefine some or all
+of the default loggers; or you can set :setting:`LOGGING_CONFIG` to ``None``
+and :ref:`handle logging config yourself <disabling-logging-configuration>`.
Logging is configured as part of the general Django ``setup()`` function.
Therefore, you can be certain that loggers are always ready for use in your