diff options
| author | Ramiro Morales <cramm0@gmail.com> | 2013-09-16 17:49:46 -0300 |
|---|---|---|
| committer | Ramiro Morales <cramm0@gmail.com> | 2013-09-16 17:53:02 -0300 |
| commit | efcf4d2bd982d58a0f2d5738779dead01438c060 (patch) | |
| tree | 19d4a9446577b79ce999539d00e86307f63d5ac7 | |
| parent | 12a30e92210144ac5e5762d55131dd10740fa463 (diff) | |
[1.5.x] Reworded a paragraph in the logging docs.
9d12f68a53 from master.
| -rw-r--r-- | docs/topics/logging.txt | 18 |
1 files changed, 10 insertions, 8 deletions
diff --git a/docs/topics/logging.txt b/docs/topics/logging.txt index 90280ddbae..c089e31b72 100644 --- a/docs/topics/logging.txt +++ b/docs/topics/logging.txt @@ -218,14 +218,16 @@ handlers, filters and formatters that you want in your logging setup, and the log levels and other properties that you want those components to have. -Prior to Django 1.5, the :setting:`LOGGING` setting overwrote the :ref:`default -Django logging configuration <default-logging-configuration>`. From Django -1.5 forward, the project's logging configuration is merged with Django's -defaults, hence you can decide if you want to add to, or replace the existing -configuration. To completely override the default configuration, set the -``disable_existing_loggers`` key to ``True`` (which is the default) in the -:setting:`LOGGING` dictConfig. Alternatively you can redefine some or all of -the loggers by setting ``disable_existing_loggers`` to ``False``. +Prior to Django 1.5, the :setting:`LOGGING` setting always overwrote the +:ref:`default Django logging configuration <default-logging-configuration>`. +From Django 1.5 forward, it is possible to get the project's logging +configuration merged with Django's defaults, hence you can decide if you want to +add to, or replace the existing configuration. + +If the ``disable_existing_loggers`` key in the :setting:`LOGGING` dictConfig is +set to ``True`` (which is the default) the default configuration is completely +overridden. Alternatively you can redefine some or all of the loggers by +setting ``disable_existing_loggers`` to ``False``. Logging is configured as soon as settings have been loaded (either manually using :func:`~django.conf.settings.configure` or when at least |
