Commits

Vinay Sajip committed 6877957 Draft Merge

Issue #17007: Merged minor changes from 3.3.

Comments (0)

Files changed (1)

Doc/library/logging.rst

 
    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)
 
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.