On 29 October 2011 15:50, Nathaniel Smith <[email protected]> wrote: > On Oct 29, 2011 4:41 AM, "mark florisson" <[email protected]> wrote: >> " >> Typed memoryviews can be used for efficient access to buffers. It is >> similar to the current buffer support, but has more features and >> cleaner syntax. A memoryview can be used in any context (function >> parameters, module-level, cdef class attribute, etc) and can be >> obtained from any object that exposes the PEP 3118 buffer interface. >> " > > FWIW, I do find this paragraph somewhat confusing, because the main > description of what a typed memoryview is assumes that I already know the > current buffer support. I think that's actually true (the ndarray[int32] > syntax, right?), but I'm not sure, and people coming to this for the first > time probably won't even know that buffers are what they're looking for. > > I'd say something like: "Typed memoryviews can be used for efficient access > to buffers. For example, you can use them to read and modify numpy arrays or > <some other awesome things> without incurring any python overhead." And put > a compare/contrast with the old syntax later, like the second paragraph or > so. > > My 2ยข, > - Nathaniel
Good idea, thanks! I'll update the documentation again. > _______________________________________________ > cython-devel mailing list > [email protected] > http://mail.python.org/mailman/listinfo/cython-devel > > _______________________________________________ cython-devel mailing list [email protected] http://mail.python.org/mailman/listinfo/cython-devel
