commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Mark R. Diggory" <mdigg...@latte.harvard.edu>
Subject [math] Details on Cutting the release
Date Thu, 29 Jan 2004 17:48:21 GMT
I'd like us to get together a solid documentation fragment so that 
releases are cut using the same approach each time.

Proposal for Current Release Cutting Strategy:

1.) Maven should be used to generate releases in the various required 
formats.

2.) We should define or override clear maven goals within the 
math/maven.xml to produce the release and clearly document the process 
for the Release Manager.

3.) We should start using version numbers and documenting when we cut in 
the project.xml and cvs tagging.

commons-math-0.1-dev is sort of a weak and inadequate starting point, 
recommend we change it to "commons-math-1.0" and start incrementing. 
Once we establish our release date, I don't see how [dev|alpha|beta|rcX] 
designations are really going to help us this early on. Lets just cut it 
and then deal with real issues that arise afterward. If our users really 
want testing versions, we can start using them.


4.) We should outline the appropriate contents and directory structuring 
for a release.The current configuration I've worked on produces the 
following:


*binary releases* (tar.gz and zip)

> Archive:  commons-math-0.1-dev.zip
>   Length     Date   Time    Name
>  --------    ----   ----    ----
>         0  01-29-04 09:31   commons-math-0.1-dev/
>     11358  01-29-04 09:31   commons-math-0.1-dev/LICENSE.txt
>         0  01-29-04 09:31   commons-math-0.1-dev/docs/
>         0  01-29-04 09:31   commons-math-0.1-dev/docs/clover/
 > ...
>      6103  01-29-04 09:31   commons-math-0.1-dev/docs/apidocs/
> ...
>    124140  01-29-04 09:31   commons-math-0.1-dev/commons-math-0.1-dev.jar
>    110531  01-29-04 09:31   commons-math-0.1-dev/commons-beanutils-1.5.jar
>    165119  01-29-04 09:31   commons-math-0.1-dev/commons-collections-2.1.jar
>     72176  01-29-04 09:31   commons-math-0.1-dev/commons-discovery-20030211.213356.jar
>     31605  01-29-04 09:31   commons-math-0.1-dev/commons-logging-1.0.3.jar
>    169763  01-29-04 09:31   commons-math-0.1-dev/commons-lang-2.0.jar


*src release* (tar.gz and zip)

> Archive:  commons-math-0.1-dev-src.zip
>   Length     Date   Time    Name
>  --------    ----   ----    ----
>         0  01-29-04 09:31   commons-math-0.1-dev/
>         0  01-29-04 09:31   commons-math-0.1-dev/src/
 >       282  01-29-04 09:31   commons-math-0.1-dev/src/conf/MANIFEST.MF
>         0  01-29-04 09:31   commons-math-0.1-dev/src/test/...
...
>         0  01-29-04 09:31   commons-math-0.1-dev/src/java/...
...
>         0  01-29-04 09:31   commons-math-0.1-dev/src/experimental/...
... (actually think this shouldn't be here).

>         0  01-29-04 09:31   commons-math-0.1-dev/src/conf/
>       370  01-29-04 09:31   commons-math-0.1-dev/maven.xml
>      4692  01-29-04 09:31   commons-math-0.1-dev/project.xml

This project.xml is the one with the dependencies resolved to a version.

>       801  01-29-04 09:31   commons-math-0.1-dev/project.properties
>     11358  01-29-04 09:31   commons-math-0.1-dev/LICENSE.txt
>      6635  01-29-04 09:31   commons-math-0.1-dev/build.xml

This build.xml is generated off the above project.xml, so its 
dependencies are resolved as well.



*jar release* (jar)

> Archive:  commons-math-0.1-dev.jar
>   Length     Date   Time    Name
>  --------    ----   ----    ----
>         0  01-29-04 09:30   META-INF/
>       423  01-29-04 09:30   META-INF/MANIFEST.MF
 >     11358  01-29-04 09:23   META-INF/LICENSE.txt
>         0  01-17-04 15:05   org/
>         0  01-17-04 15:05   org/apache/
>         0  01-17-04 15:05   org/apache/commons/
>         0  01-17-04 15:05   org/apache/commons/math/
>         0  01-17-04 15:05   org/apache/commons/math/analysis/
>         0  01-29-04 09:24   org/apache/commons/math/complex/
>         0  01-28-04 16:32   org/apache/commons/math/distribution/
>         0  01-28-04 16:32   org/apache/commons/math/linear/
>         0  01-17-04 15:05   org/apache/commons/math/random/
>         0  01-28-04 16:32   org/apache/commons/math/stat/
>         0  01-17-04 15:05   org/apache/commons/math/stat/univariate/
>         0  01-17-04 15:05   org/apache/commons/math/stat/univariate/rank/
>         0  01-17-04 15:05   org/apache/commons/math/stat/univariate/moment/
>         0  01-17-04 15:05   org/apache/commons/math/stat/univariate/summary/
>         0  01-17-04 15:05   org/apache/commons/math/special/
>         0  01-17-04 15:05   org/apache/commons/math/util/
>      1609  01-29-04 09:24   org/apache/commons/math/analysis/BisectionSolver.class
>      3033  01-29-04 09:24   org/apache/commons/math/analysis/UnivariateRealSolverImpl.class
>       799  01-29-04 09:24   org/apache/commons/math/analysis/UnivariateRealSolver.class
>       247  01-29-04 09:24   org/apache/commons/math/analysis/UnivariateRealFunction.class
...

So the jar has no tests and no experimental code within it.



Any Comments?

-Mark

-- 
Mark Diggory
Software Developer
Harvard MIT Data Center
http://www.hmdc.harvard.edu

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


Mime
View raw message