summaryrefslogtreecommitdiff
path: root/numpy/core/fromnumeric.py
diff options
context:
space:
mode:
authorInessa Pawson <inessapawson@gmail.com>2023-02-28 14:02:40 -0500
committerGitHub <noreply@github.com>2023-02-28 20:02:40 +0100
commit486878b37fc7439a3b2b87747f50db9b62fea8eb (patch)
tree163f74bb6bf2d393caa22ae9a1e52ba84c16a4e5 /numpy/core/fromnumeric.py
parent3b5eff00e49ed8ab1e6c9fa9345e51817a691b2f (diff)
downloadnumpy-486878b37fc7439a3b2b87747f50db9b62fea8eb.tar.gz
DOC: Update the docstring for `np.round_` to disrecommend it (#22527)
[skip ci]
Diffstat (limited to 'numpy/core/fromnumeric.py')
-rw-r--r--numpy/core/fromnumeric.py8
1 files changed, 6 insertions, 2 deletions
diff --git a/numpy/core/fromnumeric.py b/numpy/core/fromnumeric.py
index e7366898e..7d3336f88 100644
--- a/numpy/core/fromnumeric.py
+++ b/numpy/core/fromnumeric.py
@@ -3748,14 +3748,18 @@ def var(a, axis=None, dtype=None, out=None, ddof=0, keepdims=np._NoValue, *,
**kwargs)
-# Aliases of other functions. These have their own definitions only so that
-# they can have unique docstrings.
+# Aliases of other functions. Provided unique docstrings
+# are reference purposes only. Wherever possible,
+# avoid using them.
@array_function_dispatch(_around_dispatcher)
def round_(a, decimals=0, out=None):
"""
Round an array to the given number of decimals.
+ `~numpy.round_` is a disrecommended backwards-compatibility
+ alias of `~numpy.around` and `~numpy.round`.
+
See Also
--------
around : equivalent function; see for details.