summaryrefslogtreecommitdiff
path: root/doc/source/reference
diff options
context:
space:
mode:
authorCharles Harris <charlesr.harris@gmail.com>2020-11-25 10:27:45 -0700
committerGitHub <noreply@github.com>2020-11-25 10:27:45 -0700
commitba77419b101535e8ec14192c35b924b32b6a31bc (patch)
treead7efbc2d4648b70c4abe27c5156a8e54702dd22 /doc/source/reference
parent44f8f9d6a73920eeb04ca577267b68b90cef6e3f (diff)
parenta806c21f787132525316002926e4780243d948cc (diff)
downloadnumpy-ba77419b101535e8ec14192c35b924b32b6a31bc.tar.gz
Merge pull request #17401 from seberg/restructure-casting
MAINT: Rewrite can-cast logic in terms of NEP 42
Diffstat (limited to 'doc/source/reference')
-rw-r--r--doc/source/reference/global_state.rst15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/source/reference/global_state.rst b/doc/source/reference/global_state.rst
index 7bf9310e8..b59467210 100644
--- a/doc/source/reference/global_state.rst
+++ b/doc/source/reference/global_state.rst
@@ -83,3 +83,18 @@ in C which iterates through arrays that may or may not be
contiguous in memory.
Most users will have no reason to change these; for details
see the :ref:`memory layout <memory-layout>` documentation.
+
+Using the new casting implementation
+------------------------------------
+
+Within NumPy 1.20 it is possible to enable the new experimental casting
+implementation for testing purposes. To do this set::
+
+ NPY_USE_NEW_CASTINGIMPL=1
+
+Setting the flag is only useful to aid with NumPy developement to ensure the
+new version is bug free and should be avoided for production code.
+It is a helpful test for projects that either create custom datatypes or
+use for example complicated structured dtypes. The flag is expected to be
+removed in 1.21 with the new version being always in use.
+