[Python-Dev] docs fixes and PEP 409 (original) (raw)

Nick Coghlan ncoghlan at gmail.com
Wed Feb 1 06:57:44 CET 2012


On Wed, Feb 1, 2012 at 3:07 PM, Ethan Furman <ethan at stoneleaf.us> wrote:

I'm looking at the docs to make the relevant changes due to PEP 409, and I'm noticing some problems.

E.g. The PyExceptionGet|SetContext|Cause all talk about using NULL to clear the related attribute, when actually in should be PyNone. Only PyExceptionGetCause is directly related to PEP 409 -- should I only fix that one, and open up a new issue on the tracker for the other three, or should I fix all four now?

Passing in NULL is the right way to clear them using those APIs - the descriptors in exceptions.c then control how "not set" is exposed at the Python layer.

So only Get/SetCause should need updating for PEP 409 to say to pass in NULL to clear the cause and fall back on displaying the context and Py_None to suppress the context in the default display.

Cheers, Nick.

-- Nick Coghlan   |   ncoghlan at gmail.com   |   Brisbane, Australia



More information about the Python-Dev mailing list