On 29 October 2011 15:50, Nathaniel Smith <n...@pobox.com> wrote: > On Oct 29, 2011 4:41 AM, "mark florisson" <markflorisso...@gmail.com> 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 > cython-devel@python.org > http://mail.python.org/mailman/listinfo/cython-devel > > _______________________________________________ cython-devel mailing list cython-devel@python.org http://mail.python.org/mailman/listinfo/cython-devel
