[issue21902] Docstring of math.acosh, asinh, and atanh

2014-07-04 Thread Kevin Davies

Changes by Kevin Davies davies...@yahoo.com:


Added file: http://bugs.python.org/file35863/TI-89.png

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21902
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue21902] Docstring of math.acosh, asinh, and atanh

2014-07-04 Thread Kevin Davies

Kevin Davies added the comment:

I'm not sure what the resolution is (the patch was 'inverse', Mark said 
he'd be happy to use 'area', and Raymond quoted 'arc').  I didn't know 
this would be a big deal, and I'm sorry that I caused trouble.  But 
since one of the concerns was divergence, I thought I'd send some info 
on how the tools I've used describe it -- universally as 'inverse' in 
those that I found:

- Mathematica: ArcCosh[z] gives the inverse hyperbolic cosine [...] 
(http://reference.wolfram.com/mathematica/ref/ArcCosh.html)
- Modelica Standard Library: acosh Inverse of cosh (area hyperbolic 
cosine) 
(http://reference.wolfram.com/system-modeler/libraries/Modelica/Modelica_Math_acosh.html)
- Maple: arccosh, but unknown description 
(http://www.maplesoft.com/support/help/Maple/view.aspx?path=invtrig)
- MATLAB: acosh  Inverse hyperbolic cosine 
(http://www.mathworks.com/help/matlab/ref/acosh.html)
- TI-89 calculator: cosh-1 returns the inverse hyperbolic cosine [...] 
(from manual)

Respectfully,
Kevin

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21902
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue21902] Docstring of math.acosh, asinh, and atanh

2014-07-02 Thread Kevin Davies

Kevin Davies added the comment:

Unfortunately I'm not currently set up with Mercurial and I'm not sure 
that it makes sense to get that going just for this.

On 07/01/2014 06:47 PM, Ezio Melotti wrote:
 Ezio Melotti added the comment:

 Do you want to propose a patch?
 https://docs.python.org/3/library/math.html#hyperbolic-functions should be 
 updated as well.

 --
 assignee:  - docs@python
 components: +Documentation
 keywords: +easy
 nosy: +docs@python, ezio.melotti, mark.dickinson, rhettinger, stutzbach
 stage:  - needs patch
 type:  - enhancement
 versions: +Python 2.7, Python 3.4, Python 3.5

 ___
 Python tracker rep...@bugs.python.org
 http://bugs.python.org/issue21902
 ___


--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21902
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue21902] Docstring of math.acosh, asinh, and atanh

2014-07-02 Thread Kevin Davies

Kevin Davies added the comment:

Yes, 'inverse' is probably more obvious to understand than 'area', 
although it doesn't tie into the 'a' of 'acosh', etc.

On 07/01/2014 08:24 PM, Mark Dickinson wrote:
 Mark Dickinson added the comment:

 How about simply 'inverse hyperbolic cosine', etc.  I think that's more 
 likely to be immediately obvious to readers.

 --

 ___
 Python tracker rep...@bugs.python.org
 http://bugs.python.org/issue21902
 ___


--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21902
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue21902] Docstring of math.acosh, asinh, and atanh

2014-07-02 Thread Kevin Davies

Kevin Davies added the comment:

Mark: The patch looks good.  Thanks!

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21902
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue21902] Docstring of math.acosh, asinh, and atanh

2014-07-01 Thread Kevin Davies

New submission from Kevin Davies:

The docstring of acosh should more accurately be 
Return the area hyperbolic cosine of x.
instead of 
Return the hyperbolic arc cosine (measured in radians) of x.
asinh and atanh should be changed similarly.  The result of these functions is 
not an angle but a ratio of areas.  See 
http://en.wikipedia.org/wiki/Inverse_hyperbolic_function.

--
messages: 222067
nosy: kdavies4
priority: normal
severity: normal
status: open
title: Docstring of math.acosh, asinh, and atanh

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21902
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com