svn commit: r1291896 - /commons/proper/math/trunk/src/site/xdoc/changes.xml

[er...@apache.org]

Author: erans
Date: Tue Feb 21 16:28:58 2012
New Revision: 1291896

URL: http://svn.apache.org/viewvc?rev=1291896&view=rev
Log:
First stab at release description.

Modified:
    commons/proper/math/trunk/src/site/xdoc/changes.xml

Modified: commons/proper/math/trunk/src/site/xdoc/changes.xml
URL: http://svn.apache.org/viewvc/commons/proper/math/trunk/src/site/xdoc/changes.xml?rev=1291896&r1=1291895&r2=1291896&view=diff
==============================================================================
--- commons/proper/math/trunk/src/site/xdoc/changes.xml (original)
+++ commons/proper/math/trunk/src/site/xdoc/changes.xml Tue Feb 21 16:28:58 2012
@@ -51,10 +51,39 @@ The <action> type attribute can be add,u
     with a new-line in the release notes. (These spaces are ignored when displaying HTML).
     If the output is not quite correct, check for invisible trailing spaces!
      -->
-    <release version="3.0" date="TBD" description="TBD">
+    <release version="3.0" date="TBD" description="
+This is a major release: It combines bug fixes, new features and
+changes to existing features.
+
+Most notable among the new features are: XXX
+
+Most notable among the changes are: Exclusive use of unchecked exceptions,
+removal of interfaces for which a single implementation is assumed to exist,
+improved coding and API consistency across packages.
+
+Because of the bas package name change, this release can be used together
+with earlier versions of Commons Math.
+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 in addition to new
+features, this release includes numerous bug fixes.
+Users of Commons Math 2.0-2 should recompile their code against the 3.0 JAR
+file and must adjust the import statements to use the appropriate
+org.apache.commons.math3 base package.
+Most of the compilation errors users will encounter after the switch will be
+due to moved or deleted classes/interfaces due to package reorganization.
+
+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
+counterparts in either Math or StrictMath (cf. MATH-740). 
+">
       <action dev="erans" type="update" issue="MATH-698">
         Classes "CMAESOptimizer" and "BOBYQAOptimizer" inherit from
-        "BaseAbstractMultivariateSimpleBoundsOptimizer (in package
+        "BaseAbstractMultivariateSimpleBoundsOptimizer" (in package
         "o.a.c.m.optimization.direct").
       </action>
       <action dev="sebb" type="fix" issue="MATH-650" >