Refs -- Improved some headings and text in logging topic.
@@ -5,8 +5,8 @@ Logging
.. module:: django.utils.log
:synopsis: Logging tools for Django applications
-A quick logging primer
-======================
+Overview
+========
Django uses Python's builtin :mod:`logging` module to perform system logging.
The usage of this module is discussed in detail in Python's own documentation.
@@ -68,7 +68,7 @@ it is passed to a *Handler*.
Handlers
~~~~~~~~
-The handler is the engine that determines what happens to each message
+The *handler* is the engine that determines what happens to each message
in a logger. It describes a particular logging behavior, such as
writing a message to the screen, to a file, or to a network socket.
@@ -89,7 +89,7 @@ file for later analysis.
Filters
~~~~~~~
-A filter is used to provide additional control over which log records
+A *filter* is used to provide additional control over which log records
are passed from logger to handler.
By default, any log message that meets log level requirements will be
@@ -111,14 +111,14 @@ can be used in a chain to perform multiple filtering actions.
Formatters
~~~~~~~~~~
-Ultimately, a log record needs to be rendered as text. Formatters
+Ultimately, a log record needs to be rendered as text. *Formatters*
describe the exact format of that text. A formatter usually consists
of a Python formatting string containing
:ref:`LogRecord attributes <python:logrecord-attributes>`; however,
you can also write custom formatters to implement specific formatting behavior.
-Using logging
-=============
+How to use logging
+==================
Once you have configured your loggers, handlers, filters and
formatters, you need to place logging calls into your code. Using the
@@ -492,11 +492,11 @@ configuring the logging in your settings file will load your logging config
immediately. As such, your logging config must appear *after* any settings on
which it depends.
-Django's logging extensions
-===========================
+Django logging extension reference
+==================================
Django provides a number of utilities to handle the unique
-requirements of logging in Web server environment.
+requirements of logging in a web server environment.
Loggers
-------
