Message 143922 - Python tracker

➜

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.

In-reply-to
Author	skrah
Recipients	docs@python, mark.dickinson, skrah
Date	2011年09月12日.16:57:48
SpamBayes Score	4.317118e-05
Marked as misclassified	No
Message-id	<1315846670.45.0.93309834122.issue12965@psf.upfronthosting.co.za>

Content
I think the integer objects documentation could be clearer on a couple of points: - Despite being listed under "Concrete Objects Layer", some functions implicitly accept anything with an __int__() method. Currently only the PyLong_AsLong() documentation states this explicitly. The patch clearly distinguishes between functions that duck type and functions that don't. - The patch replaces "is greater than _MAX" instances with "out of bounds" to include the other error condition "is less than _MIN". Additionally, the patch fixes comments in longobject.c that don't state the duck typing behavior.

Content

I think the integer objects documentation could be clearer on a
couple of points:
 - Despite being listed under "Concrete Objects Layer", some
 functions implicitly accept anything with an __int__()
 method. Currently only the PyLong_AsLong() documentation
 states this explicitly.
 The patch clearly distinguishes between functions that
 duck type and functions that don't. 
 - The patch replaces "is greater than *_MAX" instances with
 "out of bounds" to include the other error condition
 "is less than *_MIN".
Additionally, the patch fixes comments in longobject.c that
don't state the duck typing behavior.

History
Date	User	Action	Args
2011年09月12日 16:57:50	skrah	set	recipients: + skrah, mark.dickinson, docs@python
2011年09月12日 16:57:50	skrah	set	messageid: <1315846670.45.0.93309834122.issue12965@psf.upfronthosting.co.za>
2011年09月12日 16:57:49	skrah	link	issue12965 messages
2011年09月12日 16:57:49	skrah	create

homepage