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

Raymond Hettinger report at bugs.python.org
Fri Jul 4 10:13:39 CEST 2014


Raymond Hettinger added the comment:

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

Please don't make this gratuitous change.  The decision about whether to use "inverse" or "arc" was cast in stone when the functions were named "acosh" etc.   The documentation for C's math.h uses "arc".  The docs for my hand calculators all use the term "arc" in the description of what the keys do.  Why create unnecessary divergence?  

If you truly think users of acosh can't cope with "arc", then add a clarifying parenthetical for "inverse".  But don't make the function name "acosh" more opaque by not showing what it actually stands for.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21902>
_______________________________________


More information about the docs mailing list