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 terry.reedy
Recipients docs@python, r.david.murray, skrah, terry.reedy, theme
Date 2014-06-02.18:02:12
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1401732132.91.0.51863470097.issue21559@psf.upfronthosting.co.za>
In-reply-to
Content
I was tempted to close this, but I think there is an issue that 'theme' has implied but not stated clearly enough. The OverflowError entry might be re-written as "Raised when the result of an arithmetic operation involving at least one non-int is too large to be represented. For pairs of ints, MemoryError is raised instead." This much is true. However, the clear implication is that a binary operation on non-ints is the only situation in which OverflowError is raised. But as theme has shown, it is not. In this sense, the doc is incomplete.

Another, unstated, situation is failure of an internal conversion from an int to an internal type. In #20539, #20539, the justification for switching from MemoryError to OverflowError when factorial input grows too large for conversion is that memory is then not filled. In #21444, the justification is history.

A third possibility is that OverflowError is used instead of ValueError when an int fails a simple range check. See #15988: _testcapi.getargs_b requires an int in range(256). -1 and 256 raise OverflowErrors. #7267 is about the same issue. An int not being in range(256) has nothing to do with the merging of integer types in 3.x.

So I think that the docs need a new sentence. Both alternatives can be summarized by "OverflowError may also be raised for integers that are outside a required range." Knowing this might help people debugging such situations.
History
Date User Action Args
2014-06-02 18:02:12terry.reedysetrecipients: + terry.reedy, r.david.murray, skrah, docs@python, theme
2014-06-02 18:02:12terry.reedysetmessageid: <1401732132.91.0.51863470097.issue21559@psf.upfronthosting.co.za>
2014-06-02 18:02:12terry.reedylinkissue21559 messages
2014-06-02 18:02:12terry.reedycreate