classification
Title: logger.propagate=True behavior clarification
Type: Stage: resolved
Components: Documentation Versions: Python 3.3, Python 2.7
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, mfogel, python-dev, vinay.sajip
Priority: normal Keywords: patch

Created on 2011-11-23 01:17 by mfogel, last changed 2011-11-23 08:56 by python-dev. This issue is now closed.

Files
File name Uploaded Description Edit
logger_propagate_doc.diff mfogel, 2011-11-23 01:17 patch for logger.propagate documentation review
Messages (2)
msg148164 - (view) Author: Mike Fogel (mfogel) Date: 2011-11-23 01:17
Hi, there's been a fair amount of confusion over the interaction between logger.propagate and the ancestor logger's handlers and level.

http://bugs.python.org/issue7535
http://bugs.python.org/issue8327
http://bugs.python.org/issue9606

I think most this confusion could be avoided if the documentation for logger.propagate were expanded to explain clearly what happens when propagate evaluates to True - right now it just explains clearly what happens when it evaluates to False.

Attached is a documentation patch that does this.

Thanks for your consideration!
msg148174 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2011-11-23 08:56
New changeset 2c173769a957 by Vinay Sajip in branch '2.7':
Closes #13459: Clarified documentation on Logger.propagate. Thanks to Mike Fogel for the patch.
http://hg.python.org/cpython/rev/2c173769a957

New changeset a9f5639e18a1 by Vinay Sajip in branch '3.2':
Closes #13459: Clarified documentation on Logger.propagate. Thanks to Mike Fogel for the patch.
http://hg.python.org/cpython/rev/a9f5639e18a1

New changeset cc6693fdf6d5 by Vinay Sajip in branch 'default':
Closes #13459: Merged fix from 3.2.
http://hg.python.org/cpython/rev/cc6693fdf6d5
History
Date User Action Args
2011-11-23 08:56:28python-devsetstatus: open -> closed

nosy: + python-dev
messages: + msg148174

resolution: fixed
stage: resolved
2011-11-23 01:17:32mfogelcreate