]> granicus.if.org Git - python/commitdiff
Issue #17007: Made minor changes to documentation wording.
authorVinay Sajip <vinay_sajip@yahoo.co.uk>
Mon, 21 Jan 2013 21:57:10 +0000 (21:57 +0000)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>
Mon, 21 Jan 2013 21:57:10 +0000 (21:57 +0000)
Doc/library/logging.rst

index b612d0d4b453eef784be75655df6cf71b2e17111..c2af8e8ed1eb54f209a068f433715256124a0395 100644 (file)
@@ -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)