You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ah...@apache.org on 2022/12/06 11:59:34 UTC
[commons-statistics] branch master updated (1e079e0 -> 1271dc3)
This is an automated email from the ASF dual-hosted git repository.
aherbert pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/commons-statistics.git
from 1e079e0 Fix typo in release notes template
new 3bae251 Add release history to site menu
new bfb8a71 Prepare for next development version as 1.1-SNAPSHOT
new 223cf9b Update README.md pages for 1.0 release
new 15eb414 Update release version properties
new d6cd4c5 Add binary compatibility check for distributions module
new 1271dc3 Updated release notes
The 6 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
README.md | 2 +-
RELEASE-NOTES.txt | 28 +++++-
commons-statistics-distribution/README.md | 1 +
commons-statistics-distribution/pom.xml | 8 +-
.../resources/{profile.jacoco => profile.japicmp} | 2 +-
commons-statistics-distribution/src/site/site.xml | 4 +-
.../examples-distribution/pom.xml | 4 +-
commons-statistics-examples/examples-jmh/pom.xml | 2 +-
commons-statistics-examples/pom.xml | 6 +-
commons-statistics-regression/pom.xml | 8 +-
dist-archive/pom.xml | 10 +-
doc/release/release.howto.txt | 52 ++++++++--
pom.xml | 16 +--
src/changes/changes.xml | 7 +-
.../resources/release-notes/RELEASE-NOTES-1.0.txt | 32 ++++++
src/site/site.xml | 3 +-
src/site/xdoc/download_statistics.xml | 107 ++++++++++++++++++---
src/site/xdoc/release-history.xml | 35 +++++++
18 files changed, 266 insertions(+), 61 deletions(-)
copy commons-statistics-distribution/src/site/resources/{profile.jacoco => profile.japicmp} (91%)
create mode 100644 src/site/resources/release-notes/RELEASE-NOTES-1.0.txt
create mode 100644 src/site/xdoc/release-history.xml
[commons-statistics] 02/06: Prepare for next development version as 1.1-SNAPSHOT
Posted by ah...@apache.org.
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-statistics.git
commit bfb8a7131ced681175e581f08c6c9f510fc856c4
Author: aherbert <ah...@apache.org>
AuthorDate: Tue Dec 6 11:11:39 2022 +0000
Prepare for next development version as 1.1-SNAPSHOT
---
RELEASE-NOTES.txt | 28 +++++-
commons-statistics-distribution/pom.xml | 8 +-
commons-statistics-distribution/src/site/site.xml | 4 +-
.../examples-distribution/pom.xml | 4 +-
commons-statistics-examples/examples-jmh/pom.xml | 2 +-
commons-statistics-examples/pom.xml | 6 +-
commons-statistics-regression/pom.xml | 8 +-
dist-archive/pom.xml | 10 +-
pom.xml | 13 ++-
src/changes/changes.xml | 7 +-
.../resources/release-notes/RELEASE-NOTES-1.0.txt | 32 ++++++
src/site/xdoc/download_statistics.xml | 107 ++++++++++++++++++---
src/site/xdoc/release-history.xml | 35 +++++++
13 files changed, 216 insertions(+), 48 deletions(-)
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index 758b102..ff4b332 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -1,12 +1,32 @@
+ Apache Commons Statistics
+ Version 1.0
+ Release Notes
- Apache Commons Statistics RELEASE NOTES
+
+INTRODUCTION:
+
+This document contains the release notes for the 1.0 version of Apache Commons Statistics.
The Apache Commons Statistics project provides tools for statistics.
-There has been no formal release of this component. 1.0-SNAPSHOT versions
-are available for testing using the Apache snapshots repository.
+This is the first release of Apache Commons Statistics.
+
+Contains the following modules:
+
+ commons-statistics-distribution.
+
+Requires Java 8.
+
+No changes defined in this version.
+
+Historical list of changes: https://commons.apache.org/proper/commons-statistics/changes-report.html
For complete information on Apache Commons Statistics, including instructions on how to submit bug
reports, patches, or suggestions for improvement, see the Apache Commons Statistics website:
-http://commons.apache.org/proper/commons-statistics/
+https://commons.apache.org/proper/commons-statistics/
+
+Download page: https://commons.apache.org/proper/commons-statistics/download_statistics.cgi
+
+Have fun!
+-Apache Commons Team
diff --git a/commons-statistics-distribution/pom.xml b/commons-statistics-distribution/pom.xml
index 0da6619..c0e0015 100644
--- a/commons-statistics-distribution/pom.xml
+++ b/commons-statistics-distribution/pom.xml
@@ -15,19 +15,17 @@
See the License for the specific language governing permissions and
limitations under the License.
-->
-<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
- xmlns="http://maven.apache.org/POM/4.0.0"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-statistics-parent</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
</parent>
<artifactId>commons-statistics-distribution</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
<name>Apache Commons Statistics Distribution</name>
<description>Statistical distributions.</description>
diff --git a/commons-statistics-distribution/src/site/site.xml b/commons-statistics-distribution/src/site/site.xml
index dc527ff..e7b664c 100644
--- a/commons-statistics-distribution/src/site/site.xml
+++ b/commons-statistics-distribution/src/site/site.xml
@@ -28,10 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
- <!-- TODO: Uncomment for initial release
<item name="Javadoc (1.0 release)"
- href="https://commons.apache.org/rng/commons-statistics-distribution/javadocs/api-1.0/index.html"/>
- -->
+ href="https://commons.apache.org/statistics/commons-statistics-distribution/javadocs/api-1.0/index.html"/>
</menu>
</body>
diff --git a/commons-statistics-examples/examples-distribution/pom.xml b/commons-statistics-examples/examples-distribution/pom.xml
index 6dbaf17..977bd07 100644
--- a/commons-statistics-examples/examples-distribution/pom.xml
+++ b/commons-statistics-examples/examples-distribution/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-statistics-examples</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
</parent>
<artifactId>commons-statistics-examples-distribution</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
<!-- This name is used in the shaded jar to provide the application title for the version information. -->
<name>Apache Commons Statistics Distribution Utilities</name>
diff --git a/commons-statistics-examples/examples-jmh/pom.xml b/commons-statistics-examples/examples-jmh/pom.xml
index 605fde1..2e4abed 100644
--- a/commons-statistics-examples/examples-jmh/pom.xml
+++ b/commons-statistics-examples/examples-jmh/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-statistics-examples</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
</parent>
<artifactId>commons-statistics-examples-jmh</artifactId>
diff --git a/commons-statistics-examples/pom.xml b/commons-statistics-examples/pom.xml
index a15a2d3..f3690f8 100644
--- a/commons-statistics-examples/pom.xml
+++ b/commons-statistics-examples/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-statistics-parent</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
</parent>
<artifactId>commons-statistics-examples</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
<packaging>pom</packaging>
<name>Apache Commons Statistics Examples</name>
@@ -58,7 +58,7 @@
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-statistics-distribution</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>info.picocli</groupId>
diff --git a/commons-statistics-regression/pom.xml b/commons-statistics-regression/pom.xml
index 4ad0d34..f786ca6 100644
--- a/commons-statistics-regression/pom.xml
+++ b/commons-statistics-regression/pom.xml
@@ -15,19 +15,17 @@
See the License for the specific language governing permissions and
limitations under the License.
-->
-<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
- xmlns="http://maven.apache.org/POM/4.0.0"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-statistics-parent</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
</parent>
<artifactId>commons-statistics-regression</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
<name>Apache Commons Statistics Regression</name>
<description>Statistical regressions.</description>
diff --git a/dist-archive/pom.xml b/dist-archive/pom.xml
index 1831314..438e2a3 100644
--- a/dist-archive/pom.xml
+++ b/dist-archive/pom.xml
@@ -23,11 +23,11 @@ under the License.
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-statistics-parent</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
</parent>
<artifactId>commons-statistics</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
<packaging>pom</packaging>
<name>Apache Commons Statistics (full distribution)</name>
<description>This module creates the Apache Commons Statistics distribution.</description>
@@ -65,18 +65,18 @@ under the License.
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-statistics-distribution</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-statistics-distribution</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
<classifier>sources</classifier>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-statistics-distribution</artifactId>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
<classifier>javadoc</classifier>
</dependency>
diff --git a/pom.xml b/pom.xml
index 69aa244..5c2b0c7 100644
--- a/pom.xml
+++ b/pom.xml
@@ -25,7 +25,7 @@
<modelVersion>4.0.0</modelVersion>
<artifactId>commons-statistics-parent</artifactId>
<packaging>pom</packaging>
- <version>1.0-SNAPSHOT</version>
+ <version>1.1-SNAPSHOT</version>
<name>Apache Commons Statistics</name>
<inceptionYear>2018</inceptionYear>
@@ -494,9 +494,8 @@
</goals>
<configuration>
<target name="empty-checkout" unless="${perform.site.checkout}">
- <mkdir dir="${commons.scmPubCheckoutDirectory}"/>
- <echo file="${commons.scmPubCheckoutDirectory}${file.separator}README"
- message="The '${commons.scmPubCheckoutDirectory}' directory is empty in child modules."/>
+ <mkdir dir="${commons.scmPubCheckoutDirectory}" />
+ <echo file="${commons.scmPubCheckoutDirectory}${file.separator}README" message="The '${commons.scmPubCheckoutDirectory}' directory is empty in child modules." />
</target>
</configuration>
</execution>
@@ -514,7 +513,7 @@
<arg line="checkout --depth immediates ${commons.scmPubUrl} ${commons.scmPubCheckoutDirectory}" />
</exec>
<!-- Create the directory in the event that no svn exectuable is on the path -->
- <mkdir dir="${commons.scmPubCheckoutDirectory}"/>
+ <mkdir dir="${commons.scmPubCheckoutDirectory}" />
<echo file="${commons.scmPubCheckoutDirectory}.README">The '${commons.scmPubCheckoutDirectory}' directory is controlled by "subversion".
Running "svn up" will download *all* the files of the live web site at
@@ -551,8 +550,8 @@ This is avoided by creating an empty directory when svn is not available.
</goals>
<configuration>
<target name="remove-checkout">
- <delete dir="${commons.scmPubCheckoutDirectory}" quiet="true"/>
- <delete file="${commons.scmPubCheckoutDirectory}.README" quiet="true"/>
+ <delete dir="${commons.scmPubCheckoutDirectory}" quiet="true" />
+ <delete file="${commons.scmPubCheckoutDirectory}.README" quiet="true" />
</target>
</configuration>
</execution>
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 927aa21..f4e3373 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -53,7 +53,12 @@ If the output is not quite correct, check for invisible trailing spaces!
</properties>
<body>
- <release version="1.0-beta1" date="2020-04-30" description="
+ <release version="1.1" date="TBD" description="
+New features, updates and bug fixes (requires Java 8).
+">
+ </release>
+
+ <release version="1.0" date="2022-12-05" description="
This is the first release of Apache Commons Statistics.
Contains the following modules:
diff --git a/src/site/resources/release-notes/RELEASE-NOTES-1.0.txt b/src/site/resources/release-notes/RELEASE-NOTES-1.0.txt
new file mode 100644
index 0000000..ff4b332
--- /dev/null
+++ b/src/site/resources/release-notes/RELEASE-NOTES-1.0.txt
@@ -0,0 +1,32 @@
+ Apache Commons Statistics
+ Version 1.0
+ Release Notes
+
+
+INTRODUCTION:
+
+This document contains the release notes for the 1.0 version of Apache Commons Statistics.
+
+The Apache Commons Statistics project provides tools for statistics.
+
+This is the first release of Apache Commons Statistics.
+
+Contains the following modules:
+
+ commons-statistics-distribution.
+
+Requires Java 8.
+
+No changes defined in this version.
+
+Historical list of changes: https://commons.apache.org/proper/commons-statistics/changes-report.html
+
+For complete information on Apache Commons Statistics, including instructions on how to submit bug
+reports, patches, or suggestions for improvement, see the Apache Commons Statistics website:
+
+https://commons.apache.org/proper/commons-statistics/
+
+Download page: https://commons.apache.org/proper/commons-statistics/download_statistics.cgi
+
+Have fun!
+-Apache Commons Team
diff --git a/src/site/xdoc/download_statistics.xml b/src/site/xdoc/download_statistics.xml
index 2e63998..bf5bb65 100644
--- a/src/site/xdoc/download_statistics.xml
+++ b/src/site/xdoc/download_statistics.xml
@@ -26,25 +26,24 @@ limitations under the License.
| commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+======================================================================+
| |
- | 1) Re-generate using: mvn commons:download-page |
-
- Do NOT re-generate before an actual release can be downloaded.
-
+ | 1) Re-generate using: mvn commons-build:download-page |
| |
| 2) Set the following properties in the component's pom: |
- | - commons.componentid (required, alphabetic, lower case) |
+ | - commons.componentid (required, alphabetic, lower case) |
| - commons.release.version (required) |
| - commons.release.name (required) |
| - commons.binary.suffix (optional) |
| (defaults to "-bin", set to "" for pre-maven2 releases) |
| - commons.release.desc (optional) |
| - commons.release.subdir (optional) |
+ | - commons.release.hash (optional, lowercase, default sha512) |
| |
- | - commons.release.2/3.version (conditional) |
- | - commons.release.2/3.name (conditional) |
- | - commons.release.2/3.binary.suffix (optional) |
- | - commons.release.2/3.desc (optional) |
- | - commons.release.2/3.subdir (optional) |
+ | - commons.release.[234].version (conditional) |
+ | - commons.release.[234].name (conditional) |
+ | - commons.release.[234].binary.suffix (optional) |
+ | - commons.release.[234].desc (optional) |
+ | - commons.release.[234].subdir (optional) |
+ | - commons.release.[234].hash (optional, lowercase, [sha512])|
| |
| 3) Example Properties |
| (commons.release.name inherited by parent: |
@@ -64,10 +63,94 @@ limitations under the License.
</properties>
<body>
<section name="Download Apache Commons Statistics">
+ <subsection name="Using a Mirror">
<p>
- "Commons Statistics" is a new component split off "Commons Math".
- There is no release yet. Come and help to make it happen!
+ We recommend you use a mirror to download our release
+ builds, but you <strong>must</strong> <a href="https://www.apache.org/info/verification.html">verify the integrity</a> of
+ the downloaded files using signatures downloaded from our main
+ distribution directories. Recent releases (48 hours) may not yet
+ be available from all the mirrors.
</p>
+
+ <p>
+ You are currently using <b>[preferred]</b>. If you
+ encounter a problem with this mirror, please select another
+ mirror. If all mirrors are failing, there are <i>backup</i>
+ mirrors (at the end of the mirrors list) that should be
+ available.
+ <br></br>
+ [if-any logo]<a href="[link]"><img align="right" src="[logo]" border="0"></img></a>[end]
+ </p>
+
+ <form action="[location]" method="get" id="SelectMirror">
+ <p>
+ Other mirrors:
+ <select name="Preferred">
+ [if-any http]
+ [for http]<option value="[http]">[http]</option>[end]
+ [end]
+ [if-any ftp]
+ [for ftp]<option value="[ftp]">[ftp]</option>[end]
+ [end]
+ [if-any backup]
+ [for backup]<option value="[backup]">[backup] (backup)</option>[end]
+ [end]
+ </select>
+ <input type="submit" value="Change"></input>
+ </p>
+ </form>
+
+ <p>
+ It is essential that you
+ <a href="https://www.apache.org/info/verification.html">verify the integrity</a>
+ of downloaded files, preferably using the <code>PGP</code> signature (<code>*.asc</code> files);
+ failing that using the <code>SHA512</code> hash (<code>*.sha512</code> checksum files).
+ </p>
+ <p>
+ The <a href="https://www.apache.org/dist/commons/KEYS">KEYS</a>
+ file contains the public PGP keys used by Apache Commons developers
+ to sign releases.
+ </p>
+ </subsection>
+ </section>
+ <section name="Apache Commons Statistics 1.0 (requires Java 8)">
+ <subsection name="Binaries">
+ <table>
+ <tr>
+ <td><a href="[preferred]/commons/statistics/binaries/commons-statistics-1.0-bin.tar.gz">commons-statistics-1.0-bin.tar.gz</a></td>
+ <td><a href="https://www.apache.org/dist/commons/statistics/binaries/commons-statistics-1.0-bin.tar.gz.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/statistics/binaries/commons-statistics-1.0-bin.tar.gz.asc">pgp</a></td>
+ </tr>
+ <tr>
+ <td><a href="[preferred]/commons/statistics/binaries/commons-statistics-1.0-bin.zip">commons-statistics-1.0-bin.zip</a></td>
+ <td><a href="https://www.apache.org/dist/commons/statistics/binaries/commons-statistics-1.0-bin.zip.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/statistics/binaries/commons-statistics-1.0-bin.zip.asc">pgp</a></td>
+ </tr>
+ </table>
+ </subsection>
+ <subsection name="Source">
+ <table>
+ <tr>
+ <td><a href="[preferred]/commons/statistics/source/commons-statistics-1.0-src.tar.gz">commons-statistics-1.0-src.tar.gz</a></td>
+ <td><a href="https://www.apache.org/dist/commons/statistics/source/commons-statistics-1.0-src.tar.gz.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/statistics/source/commons-statistics-1.0-src.tar.gz.asc">pgp</a></td>
+ </tr>
+ <tr>
+ <td><a href="[preferred]/commons/statistics/source/commons-statistics-1.0-src.zip">commons-statistics-1.0-src.zip</a></td>
+ <td><a href="https://www.apache.org/dist/commons/statistics/source/commons-statistics-1.0-src.zip.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/statistics/source/commons-statistics-1.0-src.zip.asc">pgp</a></td>
+ </tr>
+ </table>
+ </subsection>
+ </section>
+ <section name="Archives">
+ <p>
+ Older releases can be obtained from the archives.
+ </p>
+ <ul>
+ <li class="download"><a href="[preferred]/commons/statistics/">browse download area</a></li>
+ <li><a href="https://archive.apache.org/dist/commons/statistics/">archives...</a></li>
+ </ul>
</section>
</body>
</document>
diff --git a/src/site/xdoc/release-history.xml b/src/site/xdoc/release-history.xml
new file mode 100644
index 0000000..acd7568
--- /dev/null
+++ b/src/site/xdoc/release-history.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0"?>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<document>
+ <properties>
+ <title>Home</title>
+ <author email="dev@commons.apache.org">Commons Documentation Team</author>
+ </properties>
+ <body>
+ <!-- ================================================== -->
+ <section name="Commons Statistics Release History">
+ <p><em>Note.</em> For older release javadocs see the individual artifact sub-sites.</p>
+ <table>
+ <tr><th>Version</th><th>Release date (YYYY-MM-DD)</th><th>Required Java Version</th><th>Release notes</th></tr>
+ <tr>
+ <td>1.0</td><td>2022-12-05</td><td>8+</td><td><a href="release-notes/RELEASE-NOTES-1.0.txt">Release notes for 1.0</a></td>
+ </tr>
+ </table>
+
+ </section>
+ <!-- ================================================== -->
+ </body>
+</document>
[commons-statistics] 01/06: Add release history to site menu
Posted by ah...@apache.org.
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-statistics.git
commit 3bae251d417c72eb1702db1440a34b450c867105
Author: aherbert <ah...@apache.org>
AuthorDate: Tue Dec 6 10:42:02 2022 +0000
Add release history to site menu
---
src/site/site.xml | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/src/site/site.xml b/src/site/site.xml
index 086efb7..3a65cb0 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -38,9 +38,8 @@
<item name="Issue Tracking" href="/issue-tracking.html"/>
<item name="Source Repository (current)"
href="https://gitbox.apache.org/repos/asf/commons-statistics.git"/>
- <!-- <item name="Wiki" -->
- <!-- href="http://wiki.apache.org/commons/Statistics"/> -->
<item name="Developers Guide" href="/developers.html"/>
+ <item name="Release History" href="/release-history.html"/>
</menu>
<menu name="User Guide">
[commons-statistics] 06/06: Updated release notes
Posted by ah...@apache.org.
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-statistics.git
commit 1271dc3cfff0207d8deddc13aea83cae7c760537
Author: aherbert <ah...@apache.org>
AuthorDate: Tue Dec 6 11:39:16 2022 +0000
Updated release notes
---
doc/release/release.howto.txt | 52 ++++++++++++++++++++++++++++++++++++-------
1 file changed, 44 insertions(+), 8 deletions(-)
diff --git a/doc/release/release.howto.txt b/doc/release/release.howto.txt
index 294cdbd..5c160fb 100644
--- a/doc/release/release.howto.txt
+++ b/doc/release/release.howto.txt
@@ -74,7 +74,7 @@ NOTE
When performing a release it is good practice to edit a copy of these notes during the process
and merge the updated document into the repository following a release. To assist in this process
-a find-and-replace can be performed to update all the version statistics in order. For example
+a find-and-replace can be performed to update all the version numbers in order. For example
based on a previous release of 1.0:
- Next development version : 1.1 -> 1.2
@@ -118,7 +118,7 @@ that the build process can create all the necessary artifacts.
(1a)
The command
- $ JAVA_HOME="__Path_to_a_JDK__" mvn -Duser.name="__Your_Apache_id__" -Ptest-deploy -Prelease clean deploy site site:stage [-Dgpg.skip]
+ $ JAVA_HOME="__Path_to_a_JDK__" mvn -Duser.name="__Your_Apache_id__" -Ptest-deploy -Prelease clean deploy site [-Dgpg.skip]
should create the artifacts in the "target/deploy" directory. The site goal
is required for the commons release plugin even though the site is
@@ -181,6 +181,12 @@ Switch to the release branch:
$ git checkout 1.0-release
+ (3a)
+ if there are any modules not ready for release then remove them from the
+ pom.xml and delete the module:
+
+ $ git rm -r commons-statistics-regression
+
(4)
If there have been changes committed in the master branch or the version
@@ -389,6 +395,17 @@ You can then generate the release artifacts without the site generation (using J
which will transfer the artifacts to the Nexus repository located at
https://repository.apache.org/index.html#stagingRepositories
+***
+Note: 1.0 RC1 failed to create the assembly in the dist-archive module.
+Restarting with maven 'resume from' was successful:
+
+ $ mvn -Duser.name=aherbert -Duser.password=<xxx> -Prelease clean deploy site -rf :commons-statistics
+
+The reason for the error creating the assembly archives is unknown. It is not
+reproducible using test-deploy. Artifacts were staged correctly on resume
+with no configuration changes.
+***
+
The apache ID password is required to clean and deploy the binary distribution
files to svn if the svn client is not configured to locally cache the user
password.
@@ -439,6 +456,20 @@ All these files are not maven artifacts but rather distribution archives: They
belong elsewhere; hence they must also been removed from the Nexus staging
repository.
+All jar modules should have the correct entries in the manifest. The manifest
+can be read to stdout using e.g.
+
+ $ unzip -p commons-statistics-distribution/target/commons-statistics-distribution-1.0.jar META-INF/MANIFEST.MF
+
+Entries that must be specific to the module are:
+
+ Automatic-Module-Name
+ Bundle-SymbolicName
+ Export-Package
+
+The Implementation-Build entry should point to the commit hash for the release
+tag.
+
As a final validity check, the Nexus repository must be manually "closed"
before other people review the deliverables just created.
How to "close" the staging repository is explained at this page:
@@ -460,8 +491,6 @@ and add missing files. The following was performed for release 1.0:
$ cd /tmp
$ svn checkout https://dist.apache.org/repos/dist/dev/commons/statistics
$ cd statistics/1.0-RC1
- $ cp path-to-the-RC-workspace/CONTRIBUTING.md .
- $ svn add CONTRIBUTING.md
$ svn del site
$ svn commit -m "Distribution files for Commons Statistics v1.0 (RC1)."
***
@@ -495,7 +524,6 @@ Create and upload the other distribution files to the Apache servers.
Copy other files from the RC workspace:
$ cp path-to-the-RC-workspace/RELEASE-NOTES.txt .
- $ cp path-to-the-RC-workspace/CONTRIBUTING.md .
$ cp path-to-the-RC-workspace/dist-archive/target/commons-release-plugin/scm/1.0-RC1/README.html .
$ cp path-to-the-RC-workspace/dist-archive/target/*-bin.* binaries
$ cp path-to-the-RC-workspace/dist-archive/target/*-src.* source
@@ -517,7 +545,6 @@ Create and upload the other distribution files to the Apache servers.
Commit to SVN:
$ svn add \
- CONTRIBUTING.md \
README.html \
RELEASE-NOTES.txt \
binaries/* \
@@ -813,6 +840,15 @@ to work. This is done using the "doc/release/copyLongTermJavadoc.sh" script
$ doc/release/copyLongTermJavadoc.sh -r 1080991 -v 1.0
+ Note: New modules will require the 'javadocs' directory to exist on
+ the server, for example:
+
+ $ svn co https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-statistics
+ $ cd commons-statistics
+ $ mkdir commons-statistics-distribution/javadocs
+ $ svn add commons-statistics-distribution/javadocs
+ $ svn commit -m "Created Commons Statistics long-term javadocs directory"
+
Wait a few minutes for the live site to fully sync and then check
https://commons.apache.org/proper/commons-statistics/
to make sure that everything looks correct.
@@ -937,7 +973,7 @@ Subject:
The Apache Commons Team is pleased to announce the availability of
version 1.0 of "Apache Commons Statistics".
-Apache Commons Statistics provides number types and utilities.
+Apache Commons Statistics provides tools for statistics.
Changes in this version include:
@@ -973,7 +1009,7 @@ Update JIRA to close all issues resolved in this release and prepare for the nex
Batch close resolved issues without sending notification e-mails:
- Click 'View all issues and filters'.
- - Enter in the search field: project = STATISTICS AND status = resolved
+ - Enter in the advanced search field: project = STATISTICS AND status = resolved
- Select "Tools" in the top right and choose "Bulk Change" for all of your relevant issues.
Step 1: Select the issues to close.
Step 2: Select 'Transition issues'.
[commons-statistics] 05/06: Add binary compatibility check for distributions module
Posted by ah...@apache.org.
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-statistics.git
commit d6cd4c5d71c3ea67a2afaa2efb33fc552c3424d0
Author: aherbert <ah...@apache.org>
AuthorDate: Tue Dec 6 11:24:27 2022 +0000
Add binary compatibility check for distributions module
---
.../src/site/resources/profile.japicmp | 17 +++++++++++++++++
1 file changed, 17 insertions(+)
diff --git a/commons-statistics-distribution/src/site/resources/profile.japicmp b/commons-statistics-distribution/src/site/resources/profile.japicmp
new file mode 100644
index 0000000..6fe28ff
--- /dev/null
+++ b/commons-statistics-distribution/src/site/resources/profile.japicmp
@@ -0,0 +1,17 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# -----------------------------------------------------------------------------
+#
+# Empty file used to automatically trigger profile from commons parent pom
[commons-statistics] 04/06: Update release version properties
Posted by ah...@apache.org.
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-statistics.git
commit 15eb4144f95f4557738430fab48e6d32689c9fa6
Author: aherbert <ah...@apache.org>
AuthorDate: Tue Dec 6 11:21:55 2022 +0000
Update release version properties
---
pom.xml | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/pom.xml b/pom.xml
index 5c2b0c7..6abb936 100644
--- a/pom.xml
+++ b/pom.xml
@@ -93,7 +93,8 @@
<!-- This flag should only be true in the dist-archive module. -->
<commons.release.isDistModule>false</commons.release.isDistModule>
<!-- do not use snapshot suffix here -->
- <commons.release.version>1.0</commons.release.version>
+ <commons.release.version>1.1</commons.release.version>
+ <commons.bc.version>1.0</commons.bc.version>
<commons.rc.version>RC1</commons.rc.version>
<commons.release.desc>(requires Java 8)</commons.release.desc>
<commons.binary.suffix>-bin</commons.binary.suffix>
[commons-statistics] 03/06: Update README.md pages for 1.0 release
Posted by ah...@apache.org.
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-statistics.git
commit 223cf9b4ccc59935c071fc382f620926810dec86
Author: aherbert <ah...@apache.org>
AuthorDate: Tue Dec 6 11:20:17 2022 +0000
Update README.md pages for 1.0 release
---
README.md | 2 +-
commons-statistics-distribution/README.md | 1 +
2 files changed, 2 insertions(+), 1 deletion(-)
diff --git a/README.md b/README.md
index de9bc2e..e80e448 100644
--- a/README.md
+++ b/README.md
@@ -66,7 +66,7 @@ Alternatively you can pull it from the central Maven repositories:
```xml
<dependency>
<groupId>org.apache.commons</groupId>
- <artifactId>commons-statistics</artifactId>
+ <artifactId>commons-statistics-distribution</artifactId>
<version>1.0</version>
</dependency>
```
diff --git a/commons-statistics-distribution/README.md b/commons-statistics-distribution/README.md
index ac36f47..f15e2e5 100644
--- a/commons-statistics-distribution/README.md
+++ b/commons-statistics-distribution/README.md
@@ -46,6 +46,7 @@ Apache Commons Statistics Distribution
[](https://github.com/apache/commons-statistics/actions/workflows/maven.yml)
[](https://app.codecov.io/gh/apache/commons-statistics)
[](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-statistics-distribution/)
+[](https://javadoc.io/doc/org.apache.commons/commons-statistics/1.0)
[](http://www.apache.org/licenses/LICENSE-2.0.html)
Statistical distributions.