This is an automated email from the ASF dual-hosted git repository.
aherbert pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-rng.git
The following commit(s) were added to refs/heads/master by this push:
new a7245936 Update release guide site staging instructions
a7245936 is described below
commit a72459365a31a1292c1c81bd842bb0c487dfd810
Author: Alex Herbert <[email protected]>
AuthorDate: Wed Apr 15 12:35:19 2026 +0100
Update release guide site staging instructions
---
doc/release/release.howto.txt | 48 +++++++++++++++++--------------------------
1 file changed, 19 insertions(+), 29 deletions(-)
diff --git a/doc/release/release.howto.txt b/doc/release/release.howto.txt
index 7e1a6e2b..5e1b5cd2 100644
--- a/doc/release/release.howto.txt
+++ b/doc/release/release.howto.txt
@@ -548,19 +548,7 @@ Create and upload the other distribution files to the
Apache servers.
to the "dist dev" area of the svn repository. However, for multi-module
maven projects, the site is incomplete.]
-As the web site staging area is shared among all commons components and
therefore
-could be published before the vote ends, it is not recommended to use the
standard
-staging area for the release candidate. So you will just archive the site and
-transfer it to your apache personal area for review.
-Here is how to do this using "lftp" to initiate the sftp transfer. "lftp"
supports
-a mirror command for recursive transfers; don't forget the -R flag for
uploading
-instead of downloading the site.
-If you haven't setup your login on home.apache.org you will need to go to
- https://id.apache.org/
-login and copy the contents of your
- ~/.ssh/id_rsa.pub
-file to "SSH Key (authorized_keys line)".
-Then run these commands:
+Generate the multi-module site for the web site staging area.
Note: Site generation requires Java 11 for the examples JPMS modules.
With site generation the 'package' goal is required for the site report
javadoc
@@ -575,26 +563,28 @@ Then run these commands:
To ensure the javadocs are searchable from Java 8 requires a package-list.
This
can be created by copying the element-list. This is only required for the
Java 8
modules:
-
- $ find target/staging/commons-rng-client-api \
- target/staging/commons-rng-core \
- target/staging/commons-rng-simple \
- target/staging/commons-rng-sampling \
- target/staging/commons-rng-docs \
- -name element-list -execdir cp {} package-list \;
+
+ $ find target/staging -name element-list -execdir cp {} package-list \;
$ cd target
$ mv staging commons-rng-1.6-RC1-site
- $ lftp sftp://[email protected]
- lftp [email protected]:~> mkdir public_html
- lftp [email protected]:~> cd public_html
- lftp [email protected]:~/public_html> mirror -R
commons-rng-1.6-RC1-site
- lftp [email protected]:~/public_html> bye
-If lftp fails with 'Fatal error: Host key verification failed.' then the host
-key for home.apache.org may have changed. Try to ssh to the server. This will
be
-refused as only ftp connections are allowed but the error message should
-describe how to update the SSH known hosts to remove the error.
+ Checkout the dev staging area. This assumes that the site folder was removed
in
+ validation steps performed in step (12):
+
+ $ svn checkout https://dist.apache.org/repos/dist/dev/commons/rng --depth
immediates
+ $ cd rng/1.6-RC1
+
+ Update the site folder:
+
+ $ cp -pR [path/to/]commons-rng-1.6-RC1-site site
+ $ svn add site
+ $ svn commit -m "Site files for Commons RNG v1.6 (RC1)."
+
+Wait for the files to sync and validate the site at:
+
+ https://dist.apache.org/repos/dist/dev/commons/rng/1.6-RC1/site
+
(14)
[NOTE: The "Commons release-plugin" can generate the text for the "[VOTE]"
