The math and cmath functions take their parameters in 
radians, but there is nothing stating this.

The closest is "The math module consists mostly of thin 
wrappers around the platform C math library functions.".

For starters, are we guaranteed that the platform math 
functions take radians?

Logged In: YES 
user_id=80475

Yes, the platform math lib will be in radians.

You're welcome to submit a clarifying doc patch.

Logged In: YES 
user_id=31435

I checked in a major rewrite of the math module docs, as 
Doc/lib/libmath.tex revision 1.32.  This stuffed in "radians" as 
appropriate (among other things).

Note that the function docstrings already told the radiaion 
story; e.g.,

>>> print math.cos.__doc__
cos(x)

Return the cosine of x (measured in radians).
>>>

I didn't change the cmath docs, and don't intend to.  Anyone 
using complex "angles" who doesn't already know they're 
working in radians shouldn't be allowed to import cmath <0.6 
wink>.

Logged In: YES 
user_id=33168

Tim (Peters), did you want to do anything else on this or
should it be closed?

Logged In: YES 
user_id=31435

Well, if I refuse to change cmath docs, chances are nobody 
else will, so closing this <wink>.  The math module docs were 
changed.