1. python_mirrors
  2. cpython

Commits

Vinay Sajip  committed 8de6f92 Draft

Issue #17007: Made minor changes to documentation wording.

  • Participants
  • Parent commits 871519e
  • Branches 2.7

Comments (0)

Files changed (1)

File Doc/library/logging.rst

View file
  • Ignore whitespace
 
    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)