[Python-checkins] r57090 - peps/trunk/pep-3118.txt

[travis.oliphant]

Author: travis.oliphant
Date: Thu Aug 16 10:53:49 2007
New Revision: 57090

Modified:
   peps/trunk/pep-3118.txt
Log:

Fixes to the PEP 3118

Modified: peps/trunk/pep-3118.txt
==============================================================================
--- peps/trunk/pep-3118.txt	(original)
+++ peps/trunk/pep-3118.txt	Thu Aug 16 10:53:49 2007
@@ -307,7 +307,7 @@
        Py_ssize_t *shape;
        Py_ssize_t *strides;
        Py_ssize_t *suboffsets;
-       int itemsize;
+       Py_ssize_t itemsize;
        void *internal;
   } PyBuffer;
 
@@ -402,7 +402,7 @@
     be modified).  
 
 ``itemsize``
-    This is a storage for the itemsize of each element of the shared
+    This is a storage for the itemsize (in bytes) of each element of the shared
     memory.  It is technically un-necessary as it can be obtained using
     ``PyBuffer_SizeFromFormat``, however an exporter may know this
     information without parsing the format string and it is necessary
@@ -548,7 +548,7 @@
 
 ::
 
-    int PyBuffer_SizeFromFormat(const char *)
+    Py_ssize_t PyBuffer_SizeFromFormat(const char *)
 
 Return the implied itemsize of the data-format area from a struct-style
 description.
@@ -621,7 +621,7 @@
 ::
 
     void PyBuffer_FillContiguousStrides(int ndim, Py_ssize_t *shape,
-                                        Py_ssize_t *strides, int itemsize,
+                                        Py_ssize_t *strides, Py_ssize_t itemsize,
                                         char fortran)
 
 Fill the strides array with byte-strides of a contiguous (C-style if
@@ -675,7 +675,8 @@
 '(k1,k2,...,kn)'  multi-dimensional array of whatever follows 
 ':name:'          optional name of the preceeding element 
 'X{}'             pointer to a function (optional function 
-                                         signature inside {})
+                    signature inside {} with any return value
+                    preceeded by -> and placed at the end)
 ' ', '\\n', \\t'  ignored (allow better readability) 
                              -- this may already be true
 ================  ===========
@@ -718,7 +719,7 @@
 <named> is the constructor for a named-tuple (not-specified yet).
 
 float
-    ``'f'`` <--> Python float
+    ``'d'`` <--> Python float
 complex double
     ``'Zd'`` <--> Python complex
 RGB Pixel data