classification
Title: PEP 391: Adding documentation of logging.config.dictConfig
Type: Stage: patch review
Components: Documentation Versions: Python 2.7
process
Status: closed Resolution: duplicate
Dependencies: Superseder:
Assigned To: vinay.sajip Nosy List: akuchling, meatballhat, vinay.sajip
Priority: low Keywords: needs review, patch

Created on 2010-05-12 14:27 by akuchling, last changed 2010-05-14 01:41 by meatballhat. This issue is now closed.

Files
File name Uploaded Description Edit
pep391-docs.txt akuchling, 2010-05-12 14:27 Patch v1
Messages (1)
msg105589 - (view) Author: A.M. Kuchling (akuchling) * (Python committer) Date: 2010-05-12 14:27
The attached patch adds a first cut at documenting the PEP 391 dictConfig() feature.  I've taken the PEP 391 text and rearranged it to fit into the existing logging module docs.  I haven't gone through every paragraph and adjusted the markup to use Sphinx roles.

Vinay: I don't think you need to proofread every single bit of text in this patch.  I suggest you look at the following things:

* The start of the 'Configuring Logging' section, which I rewrote.

* The description of dictConfig(), which is assembled from several bits of the PEP.

* The details of the dictionary schema are moved to be first instead of last.  I therefore rewrote the paragraph in the PEP beginning "Before describing the schema in detail..." to one that begins "Describing a logging configuration requires listing..."  Is the new paragraph OK?

If you like the resulting ordering and the rewritten text, then I'll go through the rest of the text adding Sphinx markup, and commit the result.

Thanks!
History
Date User Action Args
2010-05-14 01:41:00meatballhatsetnosy: + meatballhat
2010-05-12 14:29:18akuchlingsetstatus: open -> closed
resolution: duplicate
2010-05-12 14:27:16akuchlingcreate