Merge pull request #370 from larsmans/buffer-doc

Fixes for buffer protocol docs

docs/src/userguide/buffer.rst

@@ -66,23 +66,23 @@ which Cython handles specially.
             self.shape[1] = self.ncols
 
             # Stride 1 is the distance, in bytes, between two items in a row;
-            # this is the distance between two adjance items in the vector.
+            # this is the distance between two adjacent items in the vector.
             # Stride 0 is the distance between the first elements of adjacent rows.
             self.strides[1] = <Py_ssize_t>(  <char *>&(self.v[1])
                                            - <char *>&(self.v[0]))
             self.strides[0] = self.ncols * self.strides[1]
 
             buffer.buf = <char *>&(self.v[0])
-            buffer.format = 'f'
-            buffer.internal = NULL
+            buffer.format = 'f'                     # float
+            buffer.internal = NULL                  # see References
             buffer.itemsize = itemsize
-            buffer.len = self.v.size() * itemsize
+            buffer.len = self.v.size() * itemsize   # product(shape) * itemsize
             buffer.ndim = 2
             buffer.obj = self
             buffer.readonly = 0
             buffer.shape = self.shape
             buffer.strides = self.strides
-            buffer.suboffsets = NULL
+            buffer.suboffsets = NULL                # for pointer arrays only
 
         def __releasebuffer__(self, Py_buffer *buffer):
             pass