DOC: Complete 1.5.0 release notes.

1 files changed, 28 insertions, 11 deletions

diff --git a/doc/release/1.5.0-notes.rst b/doc/release/1.5.0-notes.rst
index abccfdd2e..9a70f327c 100644
--- a/doc/release/1.5.0-notes.rst
+++ b/doc/release/1.5.0-notes.rst
@@ -3,24 +3,33 @@ NumPy 1.5.0 Release Notes
 =========================
 
 
-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 @@ turned off in the standard way:
     >>> 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 @@ instead of the longer alternative
     >>> 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 @@ small/large values, the result is often more accurate than that obtained
 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 @@ ndarrayobject.h. This allows users to include array-related types and
 enumerations without needing to concern themselves with the macro
 expansions and their side- effects.
 
+
 Changes
 =======
 
@@ -102,5 +112,12 @@ polynomial.chebyshev
 
 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.