[issue7947] Documentation of math.pow, math.hypot, and complex.__abs__

[Mark Dickinson]

Mark Dickinson <dickinsm at gmail.com> added the comment:

Thanks for reporting this.

Rather than documenting corner cases explicitly, maybe it would be enough to point to the C99 standard:  the corner cases for the math functions should (modulo bugs) all follow Annex F of the C standard, while the corner cases for the cmath functions follow Annex G.  This doesn't quite tell the complete story, because some functions (for example the cmath.rect function) don't appear in the C standards, but it would avoid cluttering the function descriptions with special cases.

Certainly the "All functions ..." sentence is inaccurate, and should be removed or revised.  I believe it's true for all single-argument functions, though.

----------
nosy: +mark.dickinson

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue7947>
_______________________________________