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

Return the cosine of x.


1. That doc-string is not very sufficient, since it
does not tell whether x should be in radians or
degrees. Same goes with sin, asin, acos and the rest of
the degree-functions.

2. ceil() and floor() could have some more information
of what the functions does. Not all users have taken
math-courses and know about them.

3. Add a degrees(x) and radians(x) that converts "x" to
degrees (from a radian argument) and to radians (from a
degree argument) respectively, it's pretty useful.

Logged In: YES 
user_id=31435

Chagned to Feature Request, Interpreter Core, and added two 
entries to PEP 42 (one for fatter docs, another for the new 
functions).

Logged In: YES 
user_id=80475

As of version 2.2, comments #1 and #2 were resolved.
Submitted patch for #3:  www.python.org/sf/552452

Logged In: YES 
user_id=80475

Comment #3 resolved.

Committed as mathmodule 2.67, 
libmath.tex 1.26 and test_math.py 1.14.

Comments #1 and #2 already solved.

Closing patch and feature request.