From bb4c141e31484ecc2af21a26cf11d9293c3d7284 Mon Sep 17 00:00:00 2001 From: Pauli Virtanen Date: Sun, 8 Mar 2009 17:12:48 +0000 Subject: doc: make the endorsement of PEP 3118 over the old array interface more strongly worder --- doc/source/reference/arrays.interface.rst | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) (limited to 'doc/source/reference/arrays.interface.rst') diff --git a/doc/source/reference/arrays.interface.rst b/doc/source/reference/arrays.interface.rst index 62f146bc1..e17bb7dfc 100644 --- a/doc/source/reference/arrays.interface.rst +++ b/doc/source/reference/arrays.interface.rst @@ -8,6 +8,19 @@ The Array Interface ******************* +.. warning:: + + This page describes the old, deprecated array interface. Everything still + works as described as of numpy 1.2 and on into the foreseeable future), but + new development should target :pep:`3118` -- + :cfunc:`The Revised Buffer Protocol `. + :pep:`3118` was incorporated into Python 2.6 and 3.0, and is additionally + supported by Cython's numpy buffer support. (See the Cython numpy + tutorial.) Cython provides a way to write code that supports the buffer + protocol with Python versions older than 2.6 because it has a + backward-compatible implementation utilizing the legacy array interface + described here. + :version: 3 The array interface (sometimes called array protocol) was created in @@ -29,12 +42,6 @@ or it can be a quite arbitrary and complicated C-like structure. There are two ways to use the interface: A Python side and a C-side. Both are separate attributes. -.. note:: - - An alternative to the array interface; - :cfunc:`The Revised Buffer Protocol `, :pep:`3118` - is introduced in Python 2.6. - Python side =========== -- cgit v1.2.1