Document update.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/math/trunk@1432412 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Gilles Sadowski 2013-01-12 12:02:15 +00:00
parent 124d57aaa6
commit cdb5465b86
1 changed files with 24 additions and 22 deletions

View File

@ -13,6 +13,8 @@ Preliminary checks:
the errors reported by the "Clirr" plugin. the errors reported by the "Clirr" plugin.
* Clear all "CheckStyle" warnings. * Clear all "CheckStyle" warnings.
* Make sure that the construct reported by "FindBugs" are intentional. * Make sure that the construct reported by "FindBugs" are intentional.
* Mark all fixed issues as such in the bug-tracking system, and add a
corresponding entry in "src/changes/changes.xml".
(1) (1)
@ -41,12 +43,12 @@ The "pom.xml" on the SVN server must always be in a state for creating snapshot
versions of the library, i.e. the tag "<version>" should end with the string versions of the library, i.e. the tag "<version>" should end with the string
"-SNAPSHOT": "-SNAPSHOT":
<version>3.2-SNAPSHOT</version> <version>3.3-SNAPSHOT</version>
Assuming that the release version will be "3.0", modify the "<version>" tag to Assuming that the release version will be "3.2", modify the "<version>" tag to
read: read:
<version>3.1</version> <version>3.2</version>
Modify the section of "<properties>" that also refers to version numbers. Modify the section of "<properties>" that also refers to version numbers.
You should uncomment the "<commons.rc.version>" line and indicate the You should uncomment the "<commons.rc.version>" line and indicate the
@ -56,7 +58,7 @@ accepted (by a vote):
<properties> <properties>
<!-- ... --> <!-- ... -->
<commons.release.version>3.1</commons.release.version> <commons.release.version>3.2</commons.release.version>
<commons.rc.version>RC1</commons.rc.version> <commons.rc.version>RC1</commons.rc.version>
<!-- ... --> <!-- ... -->
</properties> </properties>
@ -109,8 +111,8 @@ be the same as in the "<properties>" in the "pom.xml"), and the command
will be: will be:
$ svn copy . \ $ svn copy . \
-m"Creating Commons Math v3.1 RC1 tag." \ -m"Creating Commons Math v3.2 RC1 tag." \
https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_1_RC1 https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_2_RC1
The tag will then be accessible at The tag will then be accessible at
https://svn.apache.org/repos/asf/commons/proper/math/tags/ https://svn.apache.org/repos/asf/commons/proper/math/tags/
@ -119,8 +121,8 @@ The tag will then be accessible at
(6) (6)
Check out the tagged code and change into the newly created directory: Check out the tagged code and change into the newly created directory:
$ svn co https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_1_RC1 $ svn co https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_2_RC1
$ cd MATH_3_1_RC1 $ cd MATH_3_2_RC1
(7) (7)
@ -175,25 +177,25 @@ and
$ mvn site:stage-deploy \ $ mvn site:stage-deploy \
-DstagingDirectory=src/site \ -DstagingDirectory=src/site \
-DstagingSiteURL=scp://__Your_apache_login__@people.apache.org:/www/people.apache.org/builds/commons/math/3.1/RC1 -DstagingSiteURL=scp://__Your_apache_login__@people.apache.org:/www/people.apache.org/builds/commons/math/3.2/RC1
The web site will be available for review at: The web site will be available for review at:
http://people.apache.org/builds/commons/math/3.1/RC1 http://people.apache.org/builds/commons/math/3.2/RC1
(10) (10)
Call to vote by sending a message to the "dev" ML with subject Call to vote by sending a message to the "dev" ML with subject
"[VOTE] Release Commons Math 3.1". You can use the following example as "[VOTE][RC1] Release Commons Math 3.2". You can use the following example as
a starting point, replacing the URLs with the appropriate ones: a starting point, replacing the URLs with the appropriate ones:
---------- ----------
Tag: Tag:
https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_1_RC1/ https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_2_RC1/
Site: Site:
http://people.apache.org/builds/commons/math/3.1/RC1/ http://people.apache.org/builds/commons/math/3.2/RC1/
Binaries: Binaries:
https://repository.apache.org/content/repositories/orgapachecommons-051/org/apache/commons/commons-math3/3.1/ https://repository.apache.org/content/repositories/orgapachecommons-051/org/apache/commons/commons-math3/3.2/
[ ] +1 Release it. [ ] +1 Release it.
[ ] +0 Go ahead; I don't care. [ ] +0 Go ahead; I don't care.
@ -223,13 +225,13 @@ The artefacts must be copied to the distribution area on the ASF web server.
The following actions must be performed when after login into your The following actions must be performed when after login into your
"people.apache.org" account. "people.apache.org" account.
(a) Create a new directory (e.g. "cm-3.1") and "cd" into it. (a) Create a new directory (e.g. "cm-3.2") and "cd" into it.
(b) Retrieve the files from the Nexus server: (b) Retrieve the files from the Nexus server:
$ wget -r -l 1 -np -nH -nd -nv \ $ wget -r -l 1 -np -nH -nd -nv \
-e robots=off --wait 10 --no-check-certificate \ -e robots=off --wait 10 --no-check-certificate \
https://repository.apache.org/content/repositories/orgapachecommons-051/org/apache/commons/commons-math3/3.1/ https://repository.apache.org/content/repositories/orgapachecommons-051/org/apache/commons/commons-math3/3.2/
(c) Verify the checksum of each of the retrieved files. A possibility is to (c) Verify the checksum of each of the retrieved files. A possibility is to
check out the tools from check out the tools from
@ -246,11 +248,11 @@ The following actions must be performed when after login into your
Source files go to the "source" subdirectory: Source files go to the "source" subdirectory:
$ mv -i ~/cm-3.1/commons-math3-3.1-src* source $ mv -i ~/cm-3.2/commons-math3-3.2-src* source
Binary files go to the "binaries" subdirectory: Binary files go to the "binaries" subdirectory:
$ mv -i ~/cm-3.1/commons-math3-3.1-bin* binaries $ mv -i ~/cm-3.2/commons-math3-3.2-bin* binaries
(f) Check that the files permissions are all set to "-rw-rw-r--" and that (f) Check that the files permissions are all set to "-rw-rw-r--" and that
the group owner is "commons". the group owner is "commons".
@ -260,7 +262,7 @@ The following actions must be performed when after login into your
(h) Replace the "RELEASE-NOTES.txt" with the new one, e.g. using: (h) Replace the "RELEASE-NOTES.txt" with the new one, e.g. using:
$ wget --no-check-certificate https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_1_RC1/RELEASE-NOTES.txt $ wget --no-check-certificate https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_2_RC1/RELEASE-NOTES.txt
$ mv -i RELEASE-NOTES.txt.1 RELEASE-NOTES.txt $ mv -i RELEASE-NOTES.txt.1 RELEASE-NOTES.txt
(i) XXX There are no "current" symlinks in the "commmons/math" subdir (i) XXX There are no "current" symlinks in the "commmons/math" subdir
@ -285,9 +287,9 @@ Publish the web site. From your local working copy of the tag, run the command:
(15) (15)
Copy the the final RC tag to the official tag: Copy the the final RC tag to the official tag:
$ svn copy \ $ svn copy \
https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_1_RC5 \ https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_2_RC1 \
-m"RC5 becomes the 3.1 official version." \ -m"RC1 becomes the 3.2 official version." \
https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_1 https://svn.apache.org/repos/asf/commons/proper/math/tags/MATH_3_2
(16) (16)