[issue37548] Document range of atan, acos and asin
New submission from Mark Dickinson <dickinsm@gmail.com>: A small nice-to-have: it would be good to document the range of the inverse trigonometric functions `math.atan`, `math.asin` and `math.acos`, in both the docstrings and the built documentation. There are standard "principal values" for each of these inverses, and Python is using these standard values, but that may not be obvious to a user. ---------- assignee: docs@python components: Documentation messages: 347620 nosy: docs@python, mark.dickinson priority: normal severity: normal status: open title: Document range of atan, acos and asin versions: Python 2.7, Python 3.7, Python 3.8 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue37548> _______________________________________
Change by Mark Dickinson <dickinsm@gmail.com>: ---------- keywords: +easy _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue37548> _______________________________________
Change by Giovanni Cappellotto <potomak84@gmail.com>: ---------- keywords: +patch pull_requests: +14517 stage: -> patch review pull_request: https://github.com/python/cpython/pull/14717 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue37548> _______________________________________
Giovanni Cappellotto <potomak84@gmail.com> added the comment: I created a small diff to update the documentation of `math.atan`, `math.asin` and `math.acos`. ---------- nosy: +potomak _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue37548> _______________________________________
Mark Dickinson <dickinsm@gmail.com> added the comment: New changeset dc3f99fa77f415077c20a9c2b3e953e5cd894076 by Mark Dickinson (Giovanni Cappellotto) in branch 'master': bpo-37548: Document range of atan, acos and asin (GH-14717) https://github.com/python/cpython/commit/dc3f99fa77f415077c20a9c2b3e953e5cd8... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue37548> _______________________________________
Mark Dickinson <dickinsm@gmail.com> added the comment: Done for 3.9; closing. Thank you for the contribution! ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue37548> _______________________________________
participants (2)
-
Giovanni Cappellotto -
Mark Dickinson