[Cython] Cython 0.16

[Nathaniel Smith]

On Oct 29, 2011 4:41 AM, "mark florisson" <markflorisson88 at 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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/cython-devel/attachments/20111029/a5e864ee/attachment.html>