From 52b3d34d1c8a976ae0c154e5aae8390b10510a8a Mon Sep 17 00:00:00 2001 From: Vinay Sajip Date: Mon, 21 Jan 2013 21:57:10 +0000 Subject: Issue #17007: Made minor changes to documentation wording. --- Doc/library/logging.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index b612d0d..c2af8e8 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -81,14 +81,14 @@ is the module's name in the Python package namespace. The constructor sets this attribute to ``True``. - .. note:: If you attach a handler to several loggers, it may emit the same - record multiple times. In general, you should not need to attach a - handler to more than one logger - if you just attach it to the - appropriate logger which is highest in the logger hierarchy, then it - will see all events logged by all descendant loggers, provided that - their propagate setting is left set to ``True``. A common scenario is to - attach handlers only to the root logger, and let propagation take care of - the rest. + .. note:: If you attach a handler to a logger *and* one or more of its + ancestors, it may emit the same record multiple times. In general, you + should not need to attach a handler to more than one logger - if you just + attach it to the appropriate logger which is highest in the logger + hierarchy, then it will see all events logged by all descendant loggers, + provided that their propagate setting is left set to ``True``. A common + scenario is to attach handlers only to the root logger, and to let + propagation take care of the rest. .. method:: Logger.setLevel(lvl) -- cgit v0.12