summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/logging.txt21
1 files changed, 16 insertions, 5 deletions
diff --git a/docs/ref/logging.txt b/docs/ref/logging.txt
index 8c682dfceb..7fdb7791f5 100644
--- a/docs/ref/logging.txt
+++ b/docs/ref/logging.txt
@@ -1,9 +1,14 @@
-.. _logging_ref:
+.. _logging-ref:
=======
Logging
=======
+.. seealso::
+
+ * :ref:`logging-how-to`
+ * :ref:`Django logging overview <logging-explanation>`
+
.. module:: django.utils.log
:synopsis: Logging tools for Django applications
@@ -46,11 +51,17 @@ parents, up to the root ``django`` logger. The ``console`` and ``mail_admins``
handlers are attached to the root logger to provide the behavior described
above.
+Python's own defaults send records of level ``WARNING`` and higher
+to the console.
+
+.. _default-logging-definition:
+
Default logging definition
--------------------------
-The default configuration is available as ``django.utils.log.DEFAULT_LOGGING``
-and defined in :source:`django/utils/log.py`::
+Django's default logging configuration inherits Python's defaults. It's
+available as ``django.utils.log.DEFAULT_LOGGING`` and defined in
+:source:`django/utils/log.py`::
{
'version': 1,
@@ -246,8 +257,8 @@ as explained in :ref:`django-db-logger`.
Handlers
--------
-Django provides one log handler in addition to those provided by the
-Python logging module.
+Django provides one log handler in addition to :mod:`those provided by the
+Python logging module <python:logging.handlers>`.
.. class:: AdminEmailHandler(include_html=False, email_backend=None, reporter_class=None)