[Numpy-svn] r8628 - trunk/doc/release

[numpy-svn at scipy.org]

Author: rgommers
Date: 2010-08-14 08:45:26 -0500 (Sat, 14 Aug 2010)
New Revision: 8628

Modified:
   trunk/doc/release/1.5.0-notes.rst
Log:
DOC: Complete 1.5.0 release notes.

Modified: trunk/doc/release/1.5.0-notes.rst
===================================================================
--- trunk/doc/release/1.5.0-notes.rst	2010-08-14 13:45:09 UTC (rev 8627)
+++ trunk/doc/release/1.5.0-notes.rst	2010-08-14 13:45:26 UTC (rev 8628)
@@ -3,24 +3,33 @@
 =========================
 
 
-Plans
-=====
+Highlights
+==========
 
-This release has the following aims:
+Python 3 compatibility
+----------------------
 
-* Python 3 compatibility
-* :pep:`3118` compatibility
+This is the first NumPy release which is compatible with Python 3. Support for
+Python 3 and Python 2 is done from a single code base. Extensive notes on
+changes can be found at
+`<http://projects.scipy.org/numpy/browser/trunk/doc/Py3K.txt>`_.
 
+Porting of SciPy to Python 3 is expected to be completed soon.
 
-Highlights
-==========
+:pep:`3118` compatibility
+-------------------------
 
+The new buffer protocol described by PEP 3118 is fully supported in this
+version of Numpy. On Python versions >= 2.6 Numpy arrays expose the buffer
+interface, and array(), asarray() and other functions accept new-style buffers
+as input.
 
+
 New features
 ============
 
 Warning on casting complex to real
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+----------------------------------
 
 Numpy now emits a `numpy.ComplexWarning` when a complex number is cast
 into a real number. For example:
@@ -37,7 +46,7 @@
     >>> warnings.simplefilter("ignore", np.ComplexWarning)
 
 Dot method for ndarrays
-~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------
 
 Ndarrays now have the dot product also as a method, which allows writing
 chains of matrix products as
@@ -49,7 +58,7 @@
     >>> np.dot(a, np.dot(b, c))
 
 linalg.slogdet function
-~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------
 
 The slogdet function returns the sign and logarithm of the determinant
 of a matrix. Because the determinant may involve the product of many
@@ -57,7 +66,7 @@
 by simple multiplication.
 
 new header
-~~~~~~~~~~
+----------
 
 The new header file ndarraytypes.h contains the symbols from
 ndarrayobject.h that do not depend on the PY_ARRAY_UNIQUE_SYMBOL and
@@ -67,6 +76,7 @@
 enumerations without needing to concern themselves with the macro
 expansions and their side- effects.
 
+
 Changes
 =======
 
@@ -102,5 +112,12 @@
 
 histogram
 ---------
+
 After a two years transition period, the old behavior of the histogram function
 has been phased out, and the "new" keyword has been removed.
+
+correlate
+---------
+
+The old behavior of correlate was deprecated in 1.4.0, the new behavior (the
+usual definition for cross-correlation) is now the default.