diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 673651452..93f68b018 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -50,10 +50,32 @@ If the output is not quite correct, check for invisible trailing spaces!
     <title>Commons Math Release Notes</title>
   </properties>
   <body>
-    <release version="3.2" date="TBD" description="
+    <release version="3.2" date="2013-04-03" description="
 This is a minor release: It combines bug fixes and new features.
   Changes to existing features were made in a backwards-compatible
   way such as to allow drop-in replacement of the v3.1[.1] JAR file.
+  
+  Most notable among the new features are: Framework for automatic
+  differentiation, Lévy distribution, prime numbers, discrete
+  distributions, real field allowing to use several algorithms
+  (solvers, linear algebra, 3D geometry) with different real-like
+  classes (high accuracy or automatic differentiation), spherical
+  coordinates with gradients and Hessians, reorganized clustering
+  package with different distances implementations.
+  
+  The minimal version of the Java platform required to compile and use
+  Commons Math is Java 5.
+  Users are encouraged to upgrade to this version as this release not
+  only includes bug fixes but also deprecates numerous classes and
+  methods that will be deleted from the next major release (4.0).
+  
+  Caveat:
+  1. The implementation of the BOBYQA optimization algorithm is in alpha
+  state (cf. MATH-621): Many code paths are untested, and we are looking
+  for volunteers to improve the code readability, robustness and performance
+  and to extend the unit tests suite.
+  2. A few methods in the FastMath class are in fact slower that their
+  counterpart in either Math or StrictMath (cf. MATH-740 and MATH-901).
 ">
       <action dev="luc" type="fix" issue="MATH-957" due-to="Evan Ward">
         Fixed inverse cumulative probability for uniform distribution.
