Browse Source

Fixed #27931 -- Clarified the meaning of "django catch-all logger."

Kim DoHyeon 7 years ago
parent
commit
f21915bb3a
1 changed files with 8 additions and 7 deletions
  1. 8 7
      docs/topics/logging.txt

+ 8 - 7
docs/topics/logging.txt

@@ -456,8 +456,8 @@ Django provides several built-in loggers.
 ``django``
 ~~~~~~~~~~
 
-``django`` is the catch-all logger. No messages are posted directly to
-this logger.
+The catch-all logger for messages in the  ``django`` hierarchy. No messages are
+posted using this name but instead using one of the loggers below.
 
 .. _django-request-logger:
 
@@ -734,18 +734,19 @@ By default, Django configures the following logging:
 
 When :setting:`DEBUG` is ``True``:
 
-* The ``django`` catch-all logger sends all messages at the ``INFO`` level or
-  higher to the console.
+* The ``django`` logger sends messages in the ``django`` hierarchy (except
+  ``django.server``) at the ``INFO`` level or higher to the console.
 
 When :setting:`DEBUG` is ``False``:
 
-* The ``django`` logger send messages with ``ERROR`` or ``CRITICAL`` level to
+* The ``django`` logger sends messages in the ``django`` hierarchy (except
+  ``django.server``)  with ``ERROR`` or ``CRITICAL`` level to
   :class:`AdminEmailHandler`.
 
 Independent of the value of :setting:`DEBUG`:
 
-* The :ref:`django-server-logger` logger sends all messages at the ``INFO``
-  level or higher to the console.
+* The :ref:`django-server-logger` logger sends messages at the ``INFO`` level
+  or higher to the console.
 
 See also :ref:`Configuring logging <configuring-logging>` to learn how you can
 complement or replace this default logging configuration.