summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPeter Andreas Entschev <peter@entschev.com>2019-10-16 11:59:05 +0200
committerPeter Andreas Entschev <peter@entschev.com>2019-10-16 11:59:05 +0200
commitf4f02e7ff8500265d5e4b89072b5c246e842ee55 (patch)
treed8f51c89498f072a1afb59d23e8ab468d45ccba2
parentedd16e6664c48dbabd5e0446ff8306fc7a0862b5 (diff)
downloadnumpy-f4f02e7ff8500265d5e4b89072b5c246e842ee55.tar.gz
MAINT: cite few examples of array creation functions in NEP-33
-rw-r--r--doc/neps/nep-0033-array-creation-dispatch-with-array-function.rst10
1 files changed, 8 insertions, 2 deletions
diff --git a/doc/neps/nep-0033-array-creation-dispatch-with-array-function.rst b/doc/neps/nep-0033-array-creation-dispatch-with-array-function.rst
index 639ed6210..5b8fd802c 100644
--- a/doc/neps/nep-0033-array-creation-dispatch-with-array-function.rst
+++ b/doc/neps/nep-0033-array-creation-dispatch-with-array-function.rst
@@ -57,8 +57,14 @@ Implementation
--------------
The implementation requires introducing a new ``like=`` keyword to all existing
-array creation functions of NumPy. As of the writing of this NEP, a complete
-list of array creation functions can be found in [4]_.
+array creation functions of NumPy. As examples of functions that would add this
+new argument (but not limited to) we can cite those taking array-like objects
+such as ``array`` and ``asarray``, functions that create arrays based on
+numerical ranges such as ``range`` and ``linspace``, as well as the ``empty``
+family of functions, even though that may be redundant, since there exists
+already specializations for those with the naming format ``empty_like``. As of
+the writing of this NEP, a complete list of array creation functions can be
+found in [4]_.
This newly proposed keyword shall be removed by the ``__array_function__``
mechanism from the keyword dictionary before dispatching. The purpose for this