You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Phil Steitz <ph...@gmail.com> on 2010/03/25 00:18:58 UTC

Re: svn commit: r927085 - /commons/proper/math/trunk/RELEASE-NOTES.txt

sebb@apache.org wrote:
> Author: sebb
> Date: Wed Mar 24 15:26:22 2010
> New Revision: 927085
> 
> URL: http://svn.apache.org/viewvc?rev=927085&view=rev
> Log:
> Add compatibility notes from changes.xml
> 
> Modified:
>     commons/proper/math/trunk/RELEASE-NOTES.txt
> 
> Modified: commons/proper/math/trunk/RELEASE-NOTES.txt
> URL: http://svn.apache.org/viewvc/commons/proper/math/trunk/RELEASE-NOTES.txt?rev=927085&r1=927084&r2=927085&view=diff
> ==============================================================================
> --- commons/proper/math/trunk/RELEASE-NOTES.txt (original)
> +++ commons/proper/math/trunk/RELEASE-NOTES.txt Wed Mar 24 15:26:22 2010
> @@ -4,6 +4,21 @@
>  
>  This is a maintenance release including numerous bug fixes and enhancements.
>  
> +Users of version 2.0 are encouraged to upgrade to 2.1, as this release includes some important bug fixes.
> + 
> +This release contains some minor API compatibility breaks with version 2.0:
> +--------------------------------------------------------------------------
> +- the return type of RealVector.copy() has been changed to AbstractRealVector
> +- the no-argument constructor of MatrixUtils() has been made private
> +- the mapXxxToSelf methods of OpenMapRealVector have been removed and 
> +  some method return types have been changed in this class
> +- new methods have been added to the RealVector interface
> +- several fields in AdaptiveStepSizeIntegrator have been made final
> +- DummyStepInterpolator requires an additional argument for one of its constructors
> +- some protected fields have been removed from AbstractLeastSquaresOptimizer,
> +  AbstractScalarDifferentiableOptimizer and AbstractLinearOptimizer
> +- the isOptimal(SimplexTableau) method has been removed from SimplexSolver 
> +
>  Changes in this version include:
>  
>  New features:
> 
> 

Thanks!  I will merge this back in when I regenerate this file.
Somehwat kludgily, my method for generating release notes for [math] is
mvn changes:announcement-generate
mv target/announcement/math-release-notes.vm RELEASE-NOTES.txt
then tweak formatting of description, then commit the file.

Phil

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: svn commit: r927085 - /commons/proper/math/trunk/RELEASE-NOTES.txt

Posted by sebb <se...@gmail.com>.
On 25/03/2010, sebb <se...@gmail.com> wrote:
> On 24/03/2010, Phil Steitz <ph...@gmail.com> wrote:
>  > sebb@apache.org wrote:
>  >  > Author: sebb
>  >  > Date: Wed Mar 24 15:26:22 2010
>  >  > New Revision: 927085
>  >  >
>  >  > URL: http://svn.apache.org/viewvc?rev=927085&view=rev
>  >  > Log:
>  >  > Add compatibility notes from changes.xml
>  >  >
>  >  > Modified:
>  >  >     commons/proper/math/trunk/RELEASE-NOTES.txt
>  >  >
>  >  > Modified: commons/proper/math/trunk/RELEASE-NOTES.txt
>  >  > URL: http://svn.apache.org/viewvc/commons/proper/math/trunk/RELEASE-NOTES.txt?rev=927085&r1=927084&r2=927085&view=diff
>  >  > ==============================================================================
>  >  > --- commons/proper/math/trunk/RELEASE-NOTES.txt (original)
>  >  > +++ commons/proper/math/trunk/RELEASE-NOTES.txt Wed Mar 24 15:26:22 2010
>  >  > @@ -4,6 +4,21 @@
>  >  >
>  >  >  This is a maintenance release including numerous bug fixes and enhancements.
>  >  >
>  >  > +Users of version 2.0 are encouraged to upgrade to 2.1, as this release includes some important bug fixes.
>  >  > +
>  >  > +This release contains some minor API compatibility breaks with version 2.0:
>  >  > +--------------------------------------------------------------------------
>  >  > +- the return type of RealVector.copy() has been changed to AbstractRealVector
>  >  > +- the no-argument constructor of MatrixUtils() has been made private
>  >  > +- the mapXxxToSelf methods of OpenMapRealVector have been removed and
>  >  > +  some method return types have been changed in this class
>  >  > +- new methods have been added to the RealVector interface
>  >  > +- several fields in AdaptiveStepSizeIntegrator have been made final
>  >  > +- DummyStepInterpolator requires an additional argument for one of its constructors
>  >  > +- some protected fields have been removed from AbstractLeastSquaresOptimizer,
>  >  > +  AbstractScalarDifferentiableOptimizer and AbstractLinearOptimizer
>  >  > +- the isOptimal(SimplexTableau) method has been removed from SimplexSolver
>  >  > +
>  >  >  Changes in this version include:
>  >  >
>  >  >  New features:
>  >  >
>  >  >
>  >
>  >
>  > Thanks!  I will merge this back in when I regenerate this file.
>  >  Somehwat kludgily, my method for generating release notes for [math] is
>  >  mvn changes:announcement-generate
>  >  mv target/announcement/math-release-notes.vm RELEASE-NOTES.txt
>
>
> Could you not just change the output file name and have it do the mv for you?
>
>
>  >  then tweak formatting of description, then commit the file.
>
>
> I see.
>
>  It does not seem possible to include markup in the description attribute.
>
>  About the only "markup" one can use is the number of spaces at the
>  beginning of a line - these are preserved in the output (and in the
>  HTML, but of course additional spaces are not visible).
>
>  With a bit of Velocity code, I suppose this could be used as a crude
>  way of generating blank lines in the output.

Turned out to be quite easy. The Velocity template now replaces
adjacent pairs of spaces with new-line. This works fine on Windows
(not yet tried it on Un*x) and won't affect the look of changes.html.

>  Otherwise, one can at least format the description with the desired
>  line breaks and spacing in changes.xml, and copy-paste it into the
>  output release notes.

I've not dealt with line-folding, so that is the only change that
might need to be made in the generated output.

>
>  >  Phil
>  >
>  >  ---------------------------------------------------------------------
>  >  To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>  >  For additional commands, e-mail: dev-help@commons.apache.org
>  >
>  >
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: svn commit: r927085 - /commons/proper/math/trunk/RELEASE-NOTES.txt

Posted by sebb <se...@gmail.com>.
On 24/03/2010, Phil Steitz <ph...@gmail.com> wrote:
> sebb@apache.org wrote:
>  > Author: sebb
>  > Date: Wed Mar 24 15:26:22 2010
>  > New Revision: 927085
>  >
>  > URL: http://svn.apache.org/viewvc?rev=927085&view=rev
>  > Log:
>  > Add compatibility notes from changes.xml
>  >
>  > Modified:
>  >     commons/proper/math/trunk/RELEASE-NOTES.txt
>  >
>  > Modified: commons/proper/math/trunk/RELEASE-NOTES.txt
>  > URL: http://svn.apache.org/viewvc/commons/proper/math/trunk/RELEASE-NOTES.txt?rev=927085&r1=927084&r2=927085&view=diff
>  > ==============================================================================
>  > --- commons/proper/math/trunk/RELEASE-NOTES.txt (original)
>  > +++ commons/proper/math/trunk/RELEASE-NOTES.txt Wed Mar 24 15:26:22 2010
>  > @@ -4,6 +4,21 @@
>  >
>  >  This is a maintenance release including numerous bug fixes and enhancements.
>  >
>  > +Users of version 2.0 are encouraged to upgrade to 2.1, as this release includes some important bug fixes.
>  > +
>  > +This release contains some minor API compatibility breaks with version 2.0:
>  > +--------------------------------------------------------------------------
>  > +- the return type of RealVector.copy() has been changed to AbstractRealVector
>  > +- the no-argument constructor of MatrixUtils() has been made private
>  > +- the mapXxxToSelf methods of OpenMapRealVector have been removed and
>  > +  some method return types have been changed in this class
>  > +- new methods have been added to the RealVector interface
>  > +- several fields in AdaptiveStepSizeIntegrator have been made final
>  > +- DummyStepInterpolator requires an additional argument for one of its constructors
>  > +- some protected fields have been removed from AbstractLeastSquaresOptimizer,
>  > +  AbstractScalarDifferentiableOptimizer and AbstractLinearOptimizer
>  > +- the isOptimal(SimplexTableau) method has been removed from SimplexSolver
>  > +
>  >  Changes in this version include:
>  >
>  >  New features:
>  >
>  >
>
>
> Thanks!  I will merge this back in when I regenerate this file.
>  Somehwat kludgily, my method for generating release notes for [math] is
>  mvn changes:announcement-generate
>  mv target/announcement/math-release-notes.vm RELEASE-NOTES.txt

Could you not just change the output file name and have it do the mv for you?

>  then tweak formatting of description, then commit the file.

I see.

It does not seem possible to include markup in the description attribute.

About the only "markup" one can use is the number of spaces at the
beginning of a line - these are preserved in the output (and in the
HTML, but of course additional spaces are not visible).

With a bit of Velocity code, I suppose this could be used as a crude
way of generating blank lines in the output.

Otherwise, one can at least format the description with the desired
line breaks and spacing in changes.xml, and copy-paste it into the
output release notes.

>  Phil
>
>  ---------------------------------------------------------------------
>  To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>  For additional commands, e-mail: dev-help@commons.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org