[Python-checkins] cpython (merge 3.2 -> 3.3): Merged documentation update from 3.2.

Tue Jan 22 14:13:59 CET 2013

http://hg.python.org/cpython/rev/cf3ee6c9303d
changeset: 81649:cf3ee6c9303d
branch: 3.3
parent: 81645:28282e4e9d04
parent: 81648:1ff413ba4414
user: Vinay Sajip <vinay_sajip at yahoo.co.uk>
date: Tue Jan 22 13:13:16 2013 +0000
summary:
 Merged documentation update from 3.2.
files:
 Doc/howto/logging.rst | 10 ++++++++++
 Doc/howto/logging_flow.png | Bin 
 2 files changed, 10 insertions(+), 0 deletions(-)

diff --git a/Doc/howto/logging.rst b/Doc/howto/logging.rst
--- a/Doc/howto/logging.rst
+++ b/Doc/howto/logging.rst
@@ -330,6 +330,9 @@
 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 @@
 *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 0000000000000000000000000000000000000000..a88382309a18df821496c27863b17caeb68962f7
GIT binary patch
[stripped]
-- 
Repository URL: http://hg.python.org/cpython
