From: Vinay Sajip <vinay_sajip@yahoo.co.uk>
Date: Tue, 22 Jan 2013 13:12:34 +0000 (+0000)
Subject: Updated logging HOWTO with a diagram.
X-Git-Tag: v3.2.4rc1~203
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f186911e247b287d555852ce73afb721f8eb79b9;p=thirdparty%2FPython%2Fcpython.git

Updated logging HOWTO with a diagram.
---

diff --git a/Doc/howto/logging.rst b/Doc/howto/logging.rst
index c2a13d9720e9..79f1336debac 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 000000000000..a88382309a18
Binary files /dev/null and b/Doc/howto/logging_flow.png differ