Issue python#23352: Document that Py_buffer.suboffsets must be NULL if no suboffsets

skrah · skrah · commit 0dc4e153a2de · 2015-02-01T19:42:12.000+01:00
are required.
diff --git a/Doc/c-api/buffer.rst b/Doc/c-api/buffer.rst
@@ -198,6 +198,9 @@ a buffer, see :c:func:`PyObject_GetBuffer`.
       indicates that no de-referencing should occur (striding in a contiguous
       memory block).
 
+      If all suboffsets are negative (i.e. no de-referencing is needed, then
+      this field must be NULL (the default value). 
+
       This type of array representation is used by the Python Imaging Library
       (PIL). See `complex arrays`_ for further information how to access elements
       of such an array.
