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
_______________________________________________
cython-devel mailing list
cython-devel@python.org
http://mail.python.org/mailman/listinfo/cython-devel

Reply via email to