N-D array interface page is out of date

Hi, I just noticed that the N-D array interface page is outdated and doesn't mention the buffer interface that is standard with Python 2.6 and Python 3.0: http://numpy.scipy.org/array_interface.shtml This page is linked to from http://numpy.scipy.org/ I suggest, at the minimum, modifying the page with really annoying blinking red letters at the top (or other suitable warning) that this is deprecated at that people should use http://www.python.org/dev/peps/pep-3118/ instead.

Regarding http://numpy.scipy.org/array_interface.shtml : I just noticed that this out of date page is now featuring in recent discussions about the future of Numpy in Ubuntu: https://bugs.launchpad.net/ubuntu/+source/python-numpy/+bug/309215 Can someone with appropriate permissions fix the page or give me the appropriate permissions so I can do it? I think even deleting the page is better than keeping it as-is. -Andrew Andrew Straw wrote:
Hi, I just noticed that the N-D array interface page is outdated and doesn't mention the buffer interface that is standard with Python 2.6 and Python 3.0:
http://numpy.scipy.org/array_interface.shtml
This page is linked to from http://numpy.scipy.org/
I suggest, at the minimum, modifying the page with really annoying blinking red letters at the top (or other suitable warning) that this is deprecated at that people should use http://www.python.org/dev/peps/pep-3118/ instead. _______________________________________________ Numpy-discussion mailing list Numpy-discussion@scipy.org http://projects.scipy.org/mailman/listinfo/numpy-discussion

2009/2/3 Andrew Straw <strawman@astraw.com>:
Can someone with appropriate permissions fix the page or give me the appropriate permissions so I can do it? I think even deleting the page is better than keeping it as-is.
Who all has editing access to this page? Is it hosted on scipy.org? Stéfan

Hi, I have updated http://numpy.scipy.org/array_interface.shtml to have a giant warning first paragraph describing how that information is outdated. Additionally, I have updated http://numpy.scipy.org/ to point people to the buffer interface described in PEP 3118 and implemented in Python 2.6/3.0. Furthermore, I have suggested Cython has a way to write code for older Pythons that will automatically support the buffer interface in newer Pythons. If you have knowledge about these matters (Travis O. and Dag, especially), I'd appreciate it if you could read over the pages to ensure everything is actually correct. Thanks, Andrew Stéfan van der Walt wrote:
2009/2/3 Andrew Straw <strawman@astraw.com>:
Can someone with appropriate permissions fix the page or give me the appropriate permissions so I can do it? I think even deleting the page is better than keeping it as-is.
Who all has editing access to this page? Is it hosted on scipy.org?
Stéfan _______________________________________________ Numpy-discussion mailing list Numpy-discussion@scipy.org http://projects.scipy.org/mailman/listinfo/numpy-discussion

Hi, Fri, 06 Mar 2009 09:16:33 -0800, Andrew Straw wrote:
I have updated http://numpy.scipy.org/array_interface.shtml to have a giant warning first paragraph describing how that information is outdated. Additionally, I have updated http://numpy.scipy.org/ to point people to the buffer interface described in PEP 3118 and implemented in Python 2.6/3.0. Furthermore, I have suggested Cython has a way to write code for older Pythons that will automatically support the buffer interface in newer Pythons.
If you have knowledge about these matters (Travis O. and Dag, especially), I'd appreciate it if you could read over the pages to ensure everything is actually correct.
I wonder if it would make sense to redirect the page here: http://docs.scipy.org/doc/numpy/reference/arrays.interface.html so that it would be easier to edit etc. in the future? -- Pauli Virtanen

Pauli Virtanen wrote:
Hi,
Fri, 06 Mar 2009 09:16:33 -0800, Andrew Straw wrote:
I have updated http://numpy.scipy.org/array_interface.shtml to have a giant warning first paragraph describing how that information is outdated. Additionally, I have updated http://numpy.scipy.org/ to point people to the buffer interface described in PEP 3118 and implemented in Python 2.6/3.0. Furthermore, I have suggested Cython has a way to write code for older Pythons that will automatically support the buffer interface in newer Pythons.
If you have knowledge about these matters (Travis O. and Dag, especially), I'd appreciate it if you could read over the pages to ensure everything is actually correct.
I wonder if it would make sense to redirect the page here:
http://docs.scipy.org/doc/numpy/reference/arrays.interface.html
so that it would be easier to edit etc. in the future?
Yes, great idea. I just updated the page to point to the page you linked (which I didn't know existed -- thanks for pointing it out). Also, I have made several changes to arrays.interface.rst which I will upload once my password situation gets resolved.

Andrew Straw wrote:
Pauli Virtanen wrote:
Hi,
Fri, 06 Mar 2009 09:16:33 -0800, Andrew Straw wrote:
I have updated http://numpy.scipy.org/array_interface.shtml to have a giant warning first paragraph describing how that information is outdated. Additionally, I have updated http://numpy.scipy.org/ to point people to the buffer interface described in PEP 3118 and implemented in Python 2.6/3.0. Furthermore, I have suggested Cython has a way to write code for older Pythons that will automatically support the buffer interface in newer Pythons.
If you have knowledge about these matters (Travis O. and Dag, especially), I'd appreciate it if you could read over the pages to ensure everything is actually correct. I wonder if it would make sense to redirect the page here:
http://docs.scipy.org/doc/numpy/reference/arrays.interface.html
so that it would be easier to edit etc. in the future?
Yes, great idea. I just updated the page to point to the page you linked (which I didn't know existed -- thanks for pointing it out).
Also, I have made several changes to arrays.interface.rst which I will upload once my password situation gets resolved.
OK, I now have a password (thanks Gaël), but I don't have edit permissions on that page. So I'm attaching a patch against that page source that incorporates the stuff that was on the old page that's not in the new page. I'm happy to apply this myself if someone gives me edit permissions. I wasn't able to check out all the ReST formatting with the online editor because I don't have edit permissions. -Andrew

On Sun, Mar 08, 2009 at 10:18:11PM -0700, Andrew Straw wrote:
OK, I now have a password (thanks Gaël), but I don't have edit permissions on that page. So I'm attaching a patch against that page source that incorporates the stuff that was on the old page that's not in the new page.
I'm happy to apply this myself if someone gives me edit permissions. I wasn't able to check out all the ReST formatting with the online editor because I don't have edit permissions.
You don't have permissions to the corresonding page in the doc wiki: http://docs.scipy.org/numpy/docs/numpy-docs/reference/arrays.interface.rst/ ? I am a bit lost, if this is the case. Gaël

Gael Varoquaux wrote:
On Sun, Mar 08, 2009 at 10:18:11PM -0700, Andrew Straw wrote:
OK, I now have a password (thanks Gaël), but I don't have edit permissions on that page. So I'm attaching a patch against that page source that incorporates the stuff that was on the old page that's not in the new page.
I'm happy to apply this myself if someone gives me edit permissions. I wasn't able to check out all the ReST formatting with the online editor because I don't have edit permissions.
You don't have permissions to the corresonding page in the doc wiki: http://docs.scipy.org/numpy/docs/numpy-docs/reference/arrays.interface.rst/ ?
I am a bit lost, if this is the case.
OK, thanks for the pointer. Somehow I navigated to a view of that page that I could not edit. I have now uploaded my changes, including bits that didn't hadn't yet made it into the Sphinx-based documentation from the original page on numpy.scipy.org. -Andrew
participants (4)
-
Andrew Straw
-
Gael Varoquaux
-
Pauli Virtanen
-
Stéfan van der Walt