From 3163ae3d6ec2e791607df6c33dedeba311ed5c51 Mon Sep 17 00:00:00 2001 From: Sebastian Berg Date: Tue, 5 Jul 2022 17:38:57 -0700 Subject: DOC: Adopt changes as suggested in review Co-authored-by: Charles Harris --- doc/source/reference/c-api/array.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) (limited to 'doc/source/reference') diff --git a/doc/source/reference/c-api/array.rst b/doc/source/reference/c-api/array.rst index 8c0acd418..ccff2ae91 100644 --- a/doc/source/reference/c-api/array.rst +++ b/doc/source/reference/c-api/array.rst @@ -1332,12 +1332,13 @@ Special functions for NPY_OBJECT NumPy itself accepts ``NULL`` as an alias for ``None``, but may ``assert`` non-``NULL`` when compiled in debug mode. - Users **must** expect a value of ``NULL`` when working with buffers created + Because NumPy is not yet consistent about initialization with None, + users **must** expect a value of ``NULL`` when working with buffers created by NumPy. Users **should** also ensure to pass fully initialized buffers to NumPy, since NumPy may make this a strong requirement in the future. There is currently an intention to ensure that NumPy always initalizes - object arrays before it may be read. Any failure to do so will be + object arrays before they may be read. Any failure to do so will be regarded as a bug. In the future, users may be able to rely on non-NULL values when reading from any array, although exceptions for writing to freshly created arrays -- cgit v1.2.1