[Python-bugs-list] [ python-Bugs-426539 ] Math-module lacks some docs and funcs

[noreply@sourceforge.net]

Bugs item #426539, was updated on 2001-05-22 21:57
You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=105470&aid=426539&group_id=5470

Category: Extension Modules
Group: Not a Bug
Status: Open
Resolution: None
Priority: 5
Submitted By: Rikard Bosnjakovic (bosna)
Assigned to: Nobody/Anonymous (nobody)
Summary: Math-module lacks some docs and funcs

Initial Comment:
>>> 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.


----------------------------------------------------------------------

You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=105470&aid=426539&group_id=5470