Math-module lacks some docs and funcs

[bosna]

BPO	426539
Nosy	@tim-one, @rhettinger

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2002-05-13.04:03:19.000>
created_at = <Date 2001-05-23.04:57:59.000>
labels = ['type-feature']
title = 'Math-module lacks some docs and funcs'
updated_at = <Date 2002-05-13.04:03:19.000>
user = 'https://bugs.python.org/bosna'

bugs.python.org fields:

activity = <Date 2002-05-13.04:03:19.000>
actor = 'rhettinger'
assignee = 'none'
closed = True
closed_date = None
closer = None
components = ['None']
creation = <Date 2001-05-23.04:57:59.000>
creator = 'bosna'
dependencies = []
files = []
hgrepos = []
issue_num = 426539
keywords = []
message_count = 4.0
messages = ['53154', '53155', '53156', '53157']
nosy_count = 3.0
nosy_names = ['tim.peters', 'rhettinger', 'bosna']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue426539'
versions = []

[bosna]

>>> 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.

[tim-one]

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

[rhettinger]

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

[rhettinger]

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.