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

[noreply@sourceforge.net]

Feature Requests item #426539, was opened at 2001-05-23 04:57
You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=355470&aid=426539&group_id=5470

Category: None
Group: None
Status: Open
Resolution: Later
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.


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

Comment By: Raymond Hettinger (rhettinger)
Date: 2002-05-05 15:55

Message:
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


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

Comment By: Tim Peters (tim_one)
Date: 2001-06-04 18:38

Message:
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).

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

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