[1.11.x] Fixed #27931 -- Clarified the meaning of "django catch-all logger."

Backport of f21915bb3ad73001b7d987332b2b4a0ae4ec288d from master

1 files changed, 8 insertions, 7 deletions

diff --git a/docs/topics/logging.txt b/docs/topics/logging.txt
index 15a49f0d4d..066e772c7c 100644
--- a/docs/topics/logging.txt
+++ b/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:
 
@@ -740,18 +740,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.