summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2013-01-22 13:13:43 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2013-01-22 13:13:43 (GMT)
commitbe2795a6f9c0837b1139c935fc35af59c59346e3 (patch)
tree9f1c238e0d6742fda2b4af8959912ccb6752bcaa
parent2ba095c6c578d76288f5697cc121ec1f80b4f6c7 (diff)
parent7f3e993a3a318017422d493cd4daff8deb48e332 (diff)
downloadcpython-be2795a6f9c0837b1139c935fc35af59c59346e3.zip
cpython-be2795a6f9c0837b1139c935fc35af59c59346e3.tar.gz
cpython-be2795a6f9c0837b1139c935fc35af59c59346e3.tar.bz2
Merged documentation update from 3.3.
-rw-r--r--Doc/howto/logging.rst10
-rwxr-xr-xDoc/howto/logging_flow.pngbin0 -> 49648 bytes
2 files changed, 10 insertions, 0 deletions
diff --git a/Doc/howto/logging.rst b/Doc/howto/logging.rst
index c2a13d9..79f1336 100644
--- a/Doc/howto/logging.rst
+++ b/Doc/howto/logging.rst
@@ -330,6 +330,9 @@ of components: loggers, handlers, filters, and formatters.
to output.
* Formatters specify the layout of log records in the final output.
+Log event information is passed between loggers, handlers, filters and
+formatters in a :class:`LogRecord` instance.
+
Logging is performed by calling methods on instances of the :class:`Logger`
class (hereafter called :dfn:`loggers`). Each instance has a name, and they are
conceptually arranged in a namespace hierarchy using dots (periods) as
@@ -374,6 +377,13 @@ You can change this by passing a format string to :func:`basicConfig` with the
*format* keyword argument. For all options regarding how a format string is
constructed, see :ref:`formatter-objects`.
+Logging Flow
+^^^^^^^^^^^^
+
+The flow of log event information in loggers and handlers is illustrated in the
+following diagram.
+
+.. image:: logging_flow.png
Loggers
^^^^^^^
diff --git a/Doc/howto/logging_flow.png b/Doc/howto/logging_flow.png
new file mode 100755
index 0000000..a883823
--- /dev/null
+++ b/Doc/howto/logging_flow.png
Binary files differ