DEP: Deprecate `->f->fastclip` at registration time

This adds the additional deprecation of fastclip if it is set at
registration time instead of only testing that it is never used.

1 files changed, 11 insertions, 1 deletions

diff --git a/doc/source/reference/c-api/types-and-structures.rst b/doc/source/reference/c-api/types-and-structures.rst
index 5d6c2f279..60d8e420b 100644
--- a/doc/source/reference/c-api/types-and-structures.rst
+++ b/doc/source/reference/c-api/types-and-structures.rst
@@ -452,7 +452,7 @@ PyArrayDescr_Type and PyArray_Descr
            PyArray_ScalarKindFunc *scalarkind;
            int **cancastscalarkindto;
            int *cancastto;
-           PyArray_FastClipFunc *fastclip;
+           PyArray_FastClipFunc *fastclip;  /* deprecated */
            PyArray_FastPutmaskFunc *fastputmask;  /* deprecated */
            PyArray_FastTakeFunc *fasttake;  /* deprecated */
            PyArray_ArgFunc *argmin;
@@ -641,6 +641,16 @@ PyArrayDescr_Type and PyArray_Descr
     .. c:member:: void fastclip( \
             void *in, npy_intp n_in, void *min, void *max, void *out)
 
+        .. deprecated:: 1.17
+            The use of this function will give a deprecation warning when
+            ``np.clip``. Instead of this function, the datatype must
+            instead use ``PyUFunc_RegisterLoopForDescr`` to attach a custom
+            loop to ``np.core.umath.clip``, ``np.minimum``, and ``np.maximum``.
+
+        .. deprecated:: 1.19
+            Setting this function is deprecated and should always be ``NULL``,
+            if set, it will be ignored.
+
         A function that reads ``n_in`` items from ``in``, and writes to
         ``out`` the read value if it is within the limits pointed to by
         ``min`` and ``max``, or the corresponding limit if outside. The