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

Changes by Berker Peksag : -- stage: patch review -> resolved ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: h

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

Mark Dickinson added the comment: Closing as fixed. -- resolution: -> fixed status: open -> closed ___ Python tracker ___ ___ Python-

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

Mark Dickinson added the comment: Roundup message copied from #21902 (bad issue number): New changeset 36099a05d76a by Mark Dickinson in branch 'default': Issue #21092: Merge from 3.4. https://hg.python.org/cpython/rev/36099a05d76a -- ___ Python trac

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

Roundup Robot added the comment: New changeset 5edfc6c929f9 by Mark Dickinson in branch '3.4': Issue #21902: Replace incorrect 'hyperbolic arc sine' (etc.) with 'inverse hyperbolic sine' (etc.). Remove meaningless reference to radians. https://hg.python.org/cpython/rev/5edfc6c929f9 --

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

Roundup Robot added the comment: New changeset d81cabb39de3 by Mark Dickinson in branch '2.7': Issue #21902: Replace incorrect 'hyperbolic arc sine' (etc.) with 'inverse hyperbolic sine' (etc.). Remove meaningless reference to radians. https://hg.python.org/cpython/rev/d81cabb39de3 --

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

Tim Peters added the comment: One more useless ;-) data point, from Macsyma: ? acosh; -- Function: acosh () - Hyperbolic Arc Cosine. I don't like "area" - while accurate, nobody else uses it. Gratuitous novelty is no virtue ;-) I like "inverse" better than "arc", because it's all of a

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

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

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

Changes by Kevin Davies : Added file: http://bugs.python.org/file35863/TI-89.png ___ Python tracker ___ ___ Python-bugs-list mailing list Unsu

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

Raymond Hettinger added the comment: > I'd be happy to replace the 'inverse' by 'arc' > if that's what people prefer. Yes, please. > And the "in radians" bit is utterly nonsensical Yes, again. -- ___ Python tracker

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

Mark Dickinson added the comment: Raymond: I don't think it's gratuitous. I'd be happy to replace the 'inverse' by 'area' if that's what people prefer. But "hyperbolic arc cosine" is just plain incorrect. (And the "in radians" bit is utterly nonsensical.) -- ___

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

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

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

Kevin Davies added the comment: Mark: The patch looks good. Thanks! -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsub

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

Ezio Melotti added the comment: >> https://docs.python.org/3/library/math.html#hyperbolic-functions should be >> updated as well. > > It looks fine to me. What do you think should be changed? I just meant to say that the docs and the docstrings should be kept in sync (especially if they are s

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

Changes by Mark Dickinson : -- stage: needs patch -> patch review type: enhancement -> behavior ___ Python tracker ___ ___ Python-bugs

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

Mark Dickinson added the comment: Updated patch, fixing an accidental double space in the previous one. -- Added file: http://bugs.python.org/file35827/acosh_docstring_v2.patch ___ Python tracker __

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

Mark Dickinson added the comment: Kevin: does the attached patch look okay to you? -- ___ Python tracker ___ ___ Python-bugs-list mail

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

Changes by Mark Dickinson : -- assignee: docs@python -> mark.dickinson ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubs

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

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 th

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

Mark Dickinson added the comment: Ezio: > https://docs.python.org/3/library/math.html#hyperbolic-functions should be > updated as well. It looks fine to me. What do you think should be changed? -- ___ Python tracker

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

Mark Dickinson added the comment: Here's a patch. -- keywords: +patch Added file: http://bugs.python.org/file35825/acosh_docstring.patch ___ Python tracker ___ __

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

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

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

Mark Dickinson added the comment: and the 'radians' bit is obviously nonsense. -- ___ Python tracker ___ ___ Python-bugs-list mailing

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

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 ___

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

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, rhettinge

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

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