This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author zach.ware
Recipients docs@python, eric.snow, ghaering, rhettinger, zach.ware
Date 2012-11-01.19:06:03
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1351796765.71.0.512139916111.issue15067@psf.upfronthosting.co.za>
In-reply-to
Content
Coming back to this 5 months later and looking into it myself, I find that the sqlite3 docs really need a bit of a cleanup all around, especially in all three 3.x branches.  Several minor changes were made by Raymond Hettinger in d229032dc213 and a few subsequent changesets 6 months ago in the 2.7 branch, but none of those ever made it to 3.x. (Raymond, those changes in the past are why I made you nosy on this one)

To address the offending sentence that brought this issue about in the first place, after rereading it and thinking about it some more, what's there does make sense: this module uses the recipe of PEP 246, regardless of that PEP's status.  However, I don't think it's helpful to mention it in the documentation, as it kind of gives the impression that "this feature was rejected for the whole of Python, but this stdlib module goes ahead and does it anyway."  For that reason, I propose to just drop that two-line paragraph entirely.  Everything about that feature still makes sense without that paragraph, even though the 'protocol' bit seems a bit weird. I wonder though, should that feature be deprecated on the basis of using a rejected PEP as well as TOOWTDI violation (or should I open another issue to that effect anyway)?

In the same vein as Raymond's earlier 2.7 changes (namely the SQL cleanup and capitalization he did), the 2.7 patch I've attached goes through and does the same for all of the included scripts in Doc/includes/sqlite3 as well as removing the bit about PEP 246.

The 3.2 patch does everything in the 2.7 patch, plus bringing the 3.2 docs in line with the 2.7 docs.

I do have a question, though; the footnote about enabling loadable extensions is different in the 2.7 and 3.2 docs.  Which one is right, or are both right for their respective versions?

Thanks,

Zach
History
Date User Action Args
2012-11-01 19:06:06zach.waresetrecipients: + zach.ware, rhettinger, ghaering, docs@python, eric.snow
2012-11-01 19:06:05zach.waresetmessageid: <1351796765.71.0.512139916111.issue15067@psf.upfronthosting.co.za>
2012-11-01 19:06:05zach.warelinkissue15067 messages
2012-11-01 19:06:05zach.warecreate