[Math] Toward 3.0 release: First deliverables

classic Classic list List threaded Threaded
11 messages Options
Reply | Threaded
Open this post in threaded view
|

[Math] Toward 3.0 release: First deliverables

Gilles Sadowski
Hi.

I managed to complete part of the release process:

Tag on SVN:
  https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_0_RC1/

Artefacts on Nexus:
  https://repository.apache.org/content/repositories/orgapachecommons-010/

I'm still stuck with the "staged" web site (cf. other post); but you can
already have a look at the above deliverables. Please let me know of
anything that requires correction.


Regards,
Gilles

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [Math] Toward 3.0 release: First deliverables

Bruce A Johnson-2

On Mar 1, 2012, at 7:59 PM, Gilles Sadowski wrote:

> Hi.
>
> I managed to complete part of the release process:
>
> Tag on SVN:
>  https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_0_RC1/
>
> Artefacts on Nexus:
>  https://repository.apache.org/content/repositories/orgapachecommons-010/
>
> I'm still stuck with the "staged" web site (cf. other post); but you can
> already have a look at the above deliverables. Please let me know of
> anything that requires correction.
>
>
> Regards,
> Gilles
>

Release notes at

https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_0_RC1/

are for Math 2.1,

Bruce

(and keep up the good work, it looks like your almost there)



> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>
>


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

RE: [Math] Toward 3.0 release: First deliverables

Dennis Hendriks
In reply to this post by Gilles Sadowski
Hi Gilles,

https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_0_RC1/NOTICE.txt

states:

Copyright 2001-2010 The Apache Software Foundation

should this not be updated to:

Copyright 2001-2012 The Apache Software Foundation

Best regards,
Dennis


________________________________________
Van: Gilles Sadowski [[hidden email]]
Verzonden: vrijdag 2 maart 2012 1:59
Aan: [hidden email]
Onderwerp: [Math] Toward 3.0 release: First deliverables

Hi.

I managed to complete part of the release process:

Tag on SVN:
  https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_0_RC1/

Artefacts on Nexus:
  https://repository.apache.org/content/repositories/orgapachecommons-010/

I'm still stuck with the "staged" web site (cf. other post); but you can
already have a look at the above deliverables. Please let me know of
anything that requires correction.


Regards,
Gilles

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [Math] Toward 3.0 release: First deliverables

Sébastien Brisard
Hi Gilles,
could we make the following additions to the release notes?
New features
MATH-655: framework for iterative linear solvers. Implementation of
two solvers: conjugate gradient, SYMMLQ.

Changes
MATH-677, MATH-743: several changes to the API in the transform package.


Best regards,
Sébastien


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [Math] Toward 3.0 release: First deliverables

Gilles Sadowski
Hello.

> could we make the following additions to the release notes?
> New features
> MATH-655: framework for iterative linear solvers. Implementation of
> two solvers: conjugate gradient, SYMMLQ.
>
> Changes
> MATH-677, MATH-743: several changes to the API in the transform package.
>

It seems that

1. The file "RELEASE-NOTES.txt" in trunk has not changed for release 2.2
2. It was generated automatically (or it should anyways).


There is a note in the "UsingNexus" document:
---CUT---
Ensure that the release notes refer to the release version, not snapshot. If
using automatic release note generation from changes.xml, the following
command should update the file:

mvn changes:changes-report changes:announcement-generate

The file generated is target/announcement/announcement.vm
---CUT---

But it does not work here. The output of

  $ mvn changes:changes-report

is
---CUT---
INFO] Scanning for projects...
[INFO]                                                                        
[INFO] ------------------------------------------------------------------------
[INFO] Building Commons Math 3.0
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-changes-plugin:2.6:changes-report (default-cli) @ commons-math3 ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2.467s
[INFO] Finished at: Fri Mar 02 11:35:50 CET 2012
[INFO] Final Memory: 19M/174M
[INFO] ------------------------------------------------------------------------
---CUT---

It looks nice... but does not change any file!

The output of

  $ mvn changes:announcement-generate

is
---CUT---
[INFO] Scanning for projects...
[INFO]                                                                        
[INFO] ------------------------------------------------------------------------
[INFO] Building Commons Math 3.0
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-changes-plugin:2.6:announcement-generate (default-cli) @ commons-math3 ---
[WARNING] changes.xml file /home/eran/devel/SVN/commons-math/trunk/src/changes/changes.xml does not exist.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2.466s
[INFO] Finished at: Fri Mar 02 11:37:23 CET 2012
[INFO] Final Memory: 19M/174M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-changes-plugin:2.6:announcement-generate (default-cli) on project commons-math3: No releases found in any of the configured issue management systems. -> [Help 1]
[...]
---CUT---

It misses a file, so I deduce that this plugin is not used for the "math"
component; unfortunately there is no reference as to what might replace it.
:-{

There is indeed a "changes.xml" file, but it is located in "src/site/xdoc".

Since it is processed as part of the "site" plugin, I thought/imagined/hoped
that it would also generate what is referred to as "release notes"...


Regards,
Gilles

P.S. Sébastien,

     What you could do anyway is add a section in the "NOTICE.txt" file
     about the original code/algorithm.

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [Math] Toward 3.0 release: First deliverables

sebb-2-2
On 2 March 2012 10:50, Gilles Sadowski <[hidden email]> wrote:

> Hello.
>
>> could we make the following additions to the release notes?
>> New features
>> MATH-655: framework for iterative linear solvers. Implementation of
>> two solvers: conjugate gradient, SYMMLQ.
>>
>> Changes
>> MATH-677, MATH-743: several changes to the API in the transform package.
>>
>
> It seems that
>
> 1. The file "RELEASE-NOTES.txt" in trunk has not changed for release 2.2
> 2. It was generated automatically (or it should anyways).

The command to generate the release notes is:

mvn changes:announcement-generate [-Dchanges.version=3.0]

The version can be provided as shown to override the version in the POM.

>
> There is a note in the "UsingNexus" document:
> ---CUT---
> Ensure that the release notes refer to the release version, not snapshot. If
> using automatic release note generation from changes.xml, the following
> command should update the file:
>
> mvn changes:changes-report changes:announcement-generate
>
> The file generated is target/announcement/announcement.vm
> ---CUT---
>
> But it does not work here. The output of
>
>  $ mvn changes:changes-report
>
> is
> ---CUT---
> INFO] Scanning for projects...
> [INFO]
> [INFO] ------------------------------------------------------------------------
> [INFO] Building Commons Math 3.0
> [INFO] ------------------------------------------------------------------------
> [INFO]
> [INFO] --- maven-changes-plugin:2.6:changes-report (default-cli) @ commons-math3 ---
> [INFO] ------------------------------------------------------------------------
> [INFO] BUILD SUCCESS
> [INFO] ------------------------------------------------------------------------
> [INFO] Total time: 2.467s
> [INFO] Finished at: Fri Mar 02 11:35:50 CET 2012
> [INFO] Final Memory: 19M/174M
> [INFO] ------------------------------------------------------------------------
> ---CUT---
>
> It looks nice... but does not change any file!
>
> The output of
>
>  $ mvn changes:announcement-generate
>
> is
> ---CUT---
> [INFO] Scanning for projects...
> [INFO]
> [INFO] ------------------------------------------------------------------------
> [INFO] Building Commons Math 3.0
> [INFO] ------------------------------------------------------------------------
> [INFO]
> [INFO] --- maven-changes-plugin:2.6:announcement-generate (default-cli) @ commons-math3 ---
> [WARNING] changes.xml file /home/eran/devel/SVN/commons-math/trunk/src/changes/changes.xml does not exist.
> [INFO] ------------------------------------------------------------------------
> [INFO] BUILD FAILURE
> [INFO] ------------------------------------------------------------------------
> [INFO] Total time: 2.466s
> [INFO] Finished at: Fri Mar 02 11:37:23 CET 2012
> [INFO] Final Memory: 19M/174M
> [INFO] ------------------------------------------------------------------------
> [ERROR] Failed to execute goal org.apache.maven.plugins:maven-changes-plugin:2.6:announcement-generate (default-cli) on project commons-math3: No releases found in any of the configured issue management systems. -> [Help 1]
> [...]
> ---CUT---
>
> It misses a file, so I deduce that this plugin is not used for the "math"
> component; unfortunately there is no reference as to what might replace it.
> :-{
>
> There is indeed a "changes.xml" file, but it is located in "src/site/xdoc".
>
> Since it is processed as part of the "site" plugin, I thought/imagined/hoped
> that it would also generate what is referred to as "release notes"...

The command:

mvn changes:announcement-generate

works for me.

However, the file is not in the standard place (nor does it have the
standard name) as expected by commons-parent.

>
> Regards,
> Gilles
>
> P.S. Sébastien,
>
>     What you could do anyway is add a section in the "NOTICE.txt" file
>     about the original code/algorithm.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [Math] Toward 3.0 release: First deliverables

sebb-2-2
On 2 March 2012 17:41, sebb <[hidden email]> wrote:

> On 2 March 2012 10:50, Gilles Sadowski <[hidden email]> wrote:
>> Hello.
>>
>>> could we make the following additions to the release notes?
>>> New features
>>> MATH-655: framework for iterative linear solvers. Implementation of
>>> two solvers: conjugate gradient, SYMMLQ.
>>>
>>> Changes
>>> MATH-677, MATH-743: several changes to the API in the transform package.
>>>
>>
>> It seems that
>>
>> 1. The file "RELEASE-NOTES.txt" in trunk has not changed for release 2.2
>> 2. It was generated automatically (or it should anyways).
>
> The command to generate the release notes is:
>
> mvn changes:announcement-generate [-Dchanges.version=3.0]
>
> The version can be provided as shown to override the version in the POM.
>
>>
>> There is a note in the "UsingNexus" document:
>> ---CUT---
>> Ensure that the release notes refer to the release version, not snapshot. If
>> using automatic release note generation from changes.xml, the following
>> command should update the file:
>>
>> mvn changes:changes-report changes:announcement-generate
>>
>> The file generated is target/announcement/announcement.vm
>> ---CUT---
>>
>> But it does not work here. The output of
>>
>>  $ mvn changes:changes-report
>>
>> is
>> ---CUT---
>> INFO] Scanning for projects...
>> [INFO]
>> [INFO] ------------------------------------------------------------------------
>> [INFO] Building Commons Math 3.0
>> [INFO] ------------------------------------------------------------------------
>> [INFO]
>> [INFO] --- maven-changes-plugin:2.6:changes-report (default-cli) @ commons-math3 ---
>> [INFO] ------------------------------------------------------------------------
>> [INFO] BUILD SUCCESS
>> [INFO] ------------------------------------------------------------------------
>> [INFO] Total time: 2.467s
>> [INFO] Finished at: Fri Mar 02 11:35:50 CET 2012
>> [INFO] Final Memory: 19M/174M
>> [INFO] ------------------------------------------------------------------------
>> ---CUT---
>>
>> It looks nice... but does not change any file!
>>
>> The output of
>>
>>  $ mvn changes:announcement-generate
>>
>> is
>> ---CUT---
>> [INFO] Scanning for projects...
>> [INFO]
>> [INFO] ------------------------------------------------------------------------
>> [INFO] Building Commons Math 3.0
>> [INFO] ------------------------------------------------------------------------
>> [INFO]
>> [INFO] --- maven-changes-plugin:2.6:announcement-generate (default-cli) @ commons-math3 ---
>> [WARNING] changes.xml file /home/eran/devel/SVN/commons-math/trunk/src/changes/changes.xml does not exist.
>> [INFO] ------------------------------------------------------------------------
>> [INFO] BUILD FAILURE
>> [INFO] ------------------------------------------------------------------------
>> [INFO] Total time: 2.466s
>> [INFO] Finished at: Fri Mar 02 11:37:23 CET 2012
>> [INFO] Final Memory: 19M/174M
>> [INFO] ------------------------------------------------------------------------
>> [ERROR] Failed to execute goal org.apache.maven.plugins:maven-changes-plugin:2.6:announcement-generate (default-cli) on project commons-math3: No releases found in any of the configured issue management systems. -> [Help 1]
>> [...]
>> ---CUT---
>>
>> It misses a file, so I deduce that this plugin is not used for the "math"
>> component; unfortunately there is no reference as to what might replace it.
>> :-{
>>
>> There is indeed a "changes.xml" file, but it is located in "src/site/xdoc".
>>
>> Since it is processed as part of the "site" plugin, I thought/imagined/hoped
>> that it would also generate what is referred to as "release notes"...
>
> The command:
>
> mvn changes:announcement-generate
>
> works for me.
>
> However, the file is not in the standard place (nor does it have the
> standard name) as expected by commons-parent.

Fixed.

Also updated the VM file so it no longer generates LF-only EOLs on
Windows for multiline changes paragraphs.

>>
>> Regards,
>> Gilles
>>
>> P.S. Sébastien,
>>
>>     What you could do anyway is add a section in the "NOTICE.txt" file
>>     about the original code/algorithm.
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: [hidden email]
>> For additional commands, e-mail: [hidden email]
>>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [Math] Toward 3.0 release: First deliverables

Gilles Sadowski
In reply to this post by sebb-2-2
On Fri, Mar 02, 2012 at 05:41:39PM +0000, sebb wrote:

> On 2 March 2012 10:50, Gilles Sadowski <[hidden email]> wrote:
> > Hello.
> >
> >> could we make the following additions to the release notes?
> >> New features
> >> MATH-655: framework for iterative linear solvers. Implementation of
> >> two solvers: conjugate gradient, SYMMLQ.
> >>
> >> Changes
> >> MATH-677, MATH-743: several changes to the API in the transform package.
> >>
> >
> > It seems that
> >
> > 1. The file "RELEASE-NOTES.txt" in trunk has not changed for release 2.2
> > 2. It was generated automatically (or it should anyways).
>
> The command to generate the release notes is:
>
> mvn changes:announcement-generate [-Dchanges.version=3.0]

I know, I tried countless times; but it did not work here until the
"changes.xml" file was copied to the place expected by the plugin.
[I was using v2.4 and then v2.6 of the "changes" plugin.]

> >
> > It misses a file, so I deduce that this plugin is not used for the "math"
> > component; unfortunately there is no reference as to what might replace it.
> > :-{
> >
> > There is indeed a "changes.xml" file, but it is located in "src/site/xdoc".
> >
> > Since it is processed as part of the "site" plugin, I thought/imagined/hoped
> > that it would also generate what is referred to as "release notes"...
>
> The command:
>
> mvn changes:announcement-generate
>
> works for me.
>
> However, the file is not in the standard place (nor does it have the
> standard name) as expected by commons-parent.

Well, either maven is broken, or the plugin, since the same command does not
behave the same on different machines (it's Linux here). I'm glad that it
was not a PIBKAC.


Regards,
Gilles

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [Math] Toward 3.0 release: First deliverables

sebb-2-2
On 2 March 2012 20:36, Gilles Sadowski <[hidden email]> wrote:

> On Fri, Mar 02, 2012 at 05:41:39PM +0000, sebb wrote:
>> On 2 March 2012 10:50, Gilles Sadowski <[hidden email]> wrote:
>> > Hello.
>> >
>> >> could we make the following additions to the release notes?
>> >> New features
>> >> MATH-655: framework for iterative linear solvers. Implementation of
>> >> two solvers: conjugate gradient, SYMMLQ.
>> >>
>> >> Changes
>> >> MATH-677, MATH-743: several changes to the API in the transform package.
>> >>
>> >
>> > It seems that
>> >
>> > 1. The file "RELEASE-NOTES.txt" in trunk has not changed for release 2.2
>> > 2. It was generated automatically (or it should anyways).
>>
>> The command to generate the release notes is:
>>
>> mvn changes:announcement-generate [-Dchanges.version=3.0]
>
> I know, I tried countless times; but it did not work here until the
> "changes.xml" file was copied to the place expected by the plugin.
> [I was using v2.4 and then v2.6 of the "changes" plugin.]

The Math pom used to override the location; maybe that works differently in M3.

>> >
>> > It misses a file, so I deduce that this plugin is not used for the "math"
>> > component; unfortunately there is no reference as to what might replace it.
>> > :-{
>> >
>> > There is indeed a "changes.xml" file, but it is located in "src/site/xdoc".
>> >
>> > Since it is processed as part of the "site" plugin, I thought/imagined/hoped
>> > that it would also generate what is referred to as "release notes"...
>>
>> The command:
>>
>> mvn changes:announcement-generate
>>
>> works for me.
>>
>> However, the file is not in the standard place (nor does it have the
>> standard name) as expected by commons-parent.
>
> Well, either maven is broken, or the plugin, since the same command does not
> behave the same on different machines (it's Linux here). I'm glad that it
> was not a PIBKAC.

I used M2.
If you are using M3, then it may not (just) be an OS-specific issue.

>
> Regards,
> Gilles
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [Math] Toward 3.0 release: First deliverables

sebb-2-2
In reply to this post by Gilles Sadowski
On 2 March 2012 00:59, Gilles Sadowski <[hidden email]> wrote:

> Hi.
>
> I managed to complete part of the release process:
>
> Tag on SVN:
>  https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_0_RC1/
>
> Artefacts on Nexus:
>  https://repository.apache.org/content/repositories/orgapachecommons-010/
>
> I'm still stuck with the "staged" web site (cf. other post); but you can
> already have a look at the above deliverables. Please let me know of
> anything that requires correction.

I think there are quite a few things that need checking before it is
safe to do a release.
This is the first release with the new package, so it's a chance to
fix all the inherited poor APIs.

We need to try and apply all the changes that will break binary
compat. before this release, rather than after.

As such, any mutable public or protected variables should ideally be
made private.

Thread-safety is harder to achieve with mutable variables, so any
classes with setter methods should be checked to see if the setters
are really needed or not.

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [Math] Toward 3.0 release: First deliverables

Luc Maisonobe
Hi Sebb,

Le 03/03/2012 00:41, sebb a écrit :

> On 2 March 2012 00:59, Gilles Sadowski <[hidden email]> wrote:
>> Hi.
>>
>> I managed to complete part of the release process:
>>
>> Tag on SVN:
>>  https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_0_RC1/
>>
>> Artefacts on Nexus:
>>  https://repository.apache.org/content/repositories/orgapachecommons-010/
>>
>> I'm still stuck with the "staged" web site (cf. other post); but you can
>> already have a look at the above deliverables. Please let me know of
>> anything that requires correction.
>
> I think there are quite a few things that need checking before it is
> safe to do a release.
> This is the first release with the new package, so it's a chance to
> fix all the inherited poor APIs.

I think all the important problems have been addressed by now.

>
> We need to try and apply all the changes that will break binary
> compat. before this release, rather than after.

The API have been stabilized since a few weeks and reviewed. The latest
problems identified seems to me merely implementation details. such
problems can be fixed in a 3.1 version if needed. This would even force
us to really release more often, which is clearly our greatest problem
for [math] now.

>
> As such, any mutable public or protected variables should ideally be
> made private.

Some of these fields have been designed like this for years (the ODE
package was started in 2002 in another library and imported in [math] in
2006 for example). Of course we should go for better encapsulation,
better design. But we are late. Very late.

>
> Thread-safety is harder to achieve with mutable variables, so any
> classes with setter methods should be checked to see if the setters
> are really needed or not.

This cannot be adressed before 3.0. [math] is *not* thread safe and does
not intend to be, at least for now.

I strongly agree with Gilles desire to get 3.0 out soon. In fact, I know
two important operational projects that need it really really soon.
Delaying the release would be a very negative sign.

The current state of 3.0 is good. It has been used for months by
numerous users, but now some of them need an official release, they
cannot rely on a development snapshot any longer.

We must release 3.0 now.

best regards,
Luc


>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]