diff options
| author | swatantra <swatantra.kumar8@gmail.com> | 2019-06-10 00:58:30 +0530 |
|---|---|---|
| committer | Mariusz Felisiak <felisiak.mariusz@gmail.com> | 2019-06-10 13:38:49 +0200 |
| commit | 03cd3d137e2c29484b020b9768a4741f1096be97 (patch) | |
| tree | 57a3c0fcaf2101d81d08fa8ecdb677225fa86c62 /docs | |
| parent | 3ee0834a4652fb9eb8b69e09c3541901739021de (diff) | |
Fixed #30553 -- Clarified the default value of disable_existing_loggers.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/topics/logging.txt | 18 |
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 |
