diff options
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 |