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/11/01 11:55:47 UTC
[commons-numbers] 01/05: Update following release 1.1
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-numbers.git
commit c4b9ef491c7da8e3efd10db7189472c5cf730e67
Author: aherbert <ah...@apache.org>
AuthorDate: Tue Nov 1 10:44:09 2022 +0000
Update following release 1.1
---
RELEASE-NOTES.txt | 71 ++++++++++++++++++++++
commons-numbers-angle/pom.xml | 2 +-
commons-numbers-angle/src/site/site.xml | 2 +
commons-numbers-arrays/pom.xml | 2 +-
commons-numbers-arrays/src/site/site.xml | 2 +
commons-numbers-bom/pom.xml | 4 +-
commons-numbers-combinatorics/pom.xml | 2 +-
commons-numbers-combinatorics/src/site/site.xml | 2 +
commons-numbers-complex-streams/pom.xml | 2 +-
commons-numbers-complex/pom.xml | 2 +-
commons-numbers-complex/src/site/site.xml | 2 +
commons-numbers-core/pom.xml | 2 +-
commons-numbers-core/src/site/site.xml | 2 +
commons-numbers-docs/pom.xml | 26 ++++----
commons-numbers-examples/examples-jmh/pom.xml | 2 +-
commons-numbers-examples/pom.xml | 2 +-
commons-numbers-field/pom.xml | 2 +-
commons-numbers-field/src/site/site.xml | 2 +
commons-numbers-fraction/pom.xml | 2 +-
commons-numbers-fraction/src/site/site.xml | 2 +
commons-numbers-gamma/pom.xml | 2 +-
commons-numbers-gamma/src/site/site.xml | 2 +
commons-numbers-primes/pom.xml | 2 +-
commons-numbers-primes/src/site/site.xml | 2 +
commons-numbers-quaternion/pom.xml | 2 +-
commons-numbers-quaternion/src/site/site.xml | 2 +
commons-numbers-rootfinder/pom.xml | 2 +-
commons-numbers-rootfinder/src/site/site.xml | 2 +
dist-archive/pom.xml | 10 ++-
pom.xml | 2 +-
src/changes/changes.xml | 23 ++++---
.../resources/release-notes/RELEASE-NOTES-1.1.txt | 71 ++++++++++++++++++++++
src/site/xdoc/download_numbers.xml | 26 ++++----
src/site/xdoc/release-history.xml | 3 +
34 files changed, 228 insertions(+), 58 deletions(-)
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index b7f93984..2d8e52a9 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -1,4 +1,75 @@
+ Apache Commons Numbers 1.1 RELEASE NOTES
+
+The Apache Commons Numbers team is pleased to announce the release of
+commons-numbers-parent-1.1
+
+The Apache Commons Numbers project provides number types and utilities.
+
+New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires Java 8.
+
+Changes in this version include:
+
+New features:
+o NUMBERS-70: Add a user guide.
+o NUMBERS-190: Add a Bill of Materials (BOM) to aid in dependency management when referencing
+ multiple Apache Commons Numbers artifacts. The BOM should be used to ensure all
+ imported artifacts are compatible.
+o NUMBERS-181: Updated support for the beta functions. "RegularizedBeta": Added the
+ complement and derivative of the regularized beta function.
+ Added "IncompleteBeta" and "Beta" classes.
+ Functionality is ported from the Boost C++ library.
+o NUMBERS-180: "GammaRatio": Compute the ratio of two gamma functions.
+o NUMBERS-177: "Erfcx": Compute a scaled complementary error function:
+ erfcx(z) = erfc(z) * exp(z*z).
+o NUMBERS-175: "GeneralizedContinuedFraction": A continued fraction class to compute using a
+ generator. Allows evaluation of continued fractions from a regular series where
+ coefficients can be computed iteratively from the previous coefficients.
+
+Fixed Bugs:
+o NUMBERS-185: "Precision": Allow Precision.compareTo using a maxUlps to be used for sorting.
+ This corrects handling of NaN comparisons.
+o NUMBERS-182: "LogBeta": Avoid overflow for tiny arguments.
+o "BrentSolver": Avoid overflow creating the initial value between the lower and upper.
+o NUMBERS-173: "ContinuedFraction": Set a minimum bound on the relative error epsilon. Prevents
+ an infinite loop when the epsilon is zero.
+o "FactorialDouble": Prevent caching values that are infinite. The cache will support
+ factorials up to 170.
+o NUMBERS-170: "RegularizedBeta": Detect edge cases for arguments that can be evaluated by
+ exploiting properties of the regularized beta function.
+o NUMBERS-168: "BrentSolver": Identify brackets with small objective values.
+o Fix wrong javadoc. Thanks to Arturo Bernal.
+
+Changes:
+o NUMBERS-184: "Precision": Reduce number of operations in Precision.equals using a maxUlps.
+o NUMBERS-183: Improve the binomial coefficient classes. Avoid recursive method calls.
+ Avoid overflow for BinomialCoefficientDouble for large results close to infinity.
+ Use precomputed factorials and the LogBeta function for efficiency.
+o NUMBERS-178: "Factorial/FactorialDouble": Tabulate all factorials with exact 64-bit double
+ representations of n! up to n=170. This change deprecates the FactorialDouble
+ class and removes obsolete caching functionality.
+o NUMBERS-176: "ContinuedFraction": Update to use a shared implementation with
+ GeneralizedContinuedFraction.
+o NUMBERS-174: "Gamma/LogGamma/RegularizedGamma": Update the gamma function implementations to
+ increase accuracy and support for extreme values.
+ Functionality is ported from the Boost C++ library.
+o NUMBERS-172: "Erf/Erfc": Use a rational function approximation accurate to 53-bits of precision.
+ This replaces the use of the regularized gamma functions P and Q and increases accuracy
+ at extreme limits of the function. Execution speed is improved.
+ Functionality is ported from the Boost C++ library.
+o NUMBERS-171: "InverseErfc": Support full range of [0, 2]. This lowers the supported
+ minimum value from 2^-53 to double min value. Execution speed is improved.
+ Functionality is ported from the Boost C++ library.
+
+
+For complete information on Apache Commons Numbers, including instructions on how to submit bug
+reports, patches, or suggestions for improvement, see the Apache Commons Numbers website:
+
+http://commons.apache.org/proper/commons-numbers/
+
+
+=============================================================================
+
Apache Commons Numbers 1.0 RELEASE NOTES
The Apache Commons Numbers team is pleased to announce the release of
diff --git a/commons-numbers-angle/pom.xml b/commons-numbers-angle/pom.xml
index caebc1e8..3d296e0b 100644
--- a/commons-numbers-angle/pom.xml
+++ b/commons-numbers-angle/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-angle</artifactId>
diff --git a/commons-numbers-angle/src/site/site.xml b/commons-numbers-angle/src/site/site.xml
index e404cae1..f00f802a 100644
--- a/commons-numbers-angle/src/site/site.xml
+++ b/commons-numbers-angle/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.1 release)"
+ href="http://commons.apache.org/numbers/commons-numbers-angle/javadocs/api-1.1/index.html"/>
<item name="Javadoc (1.0 release)"
href="http://commons.apache.org/numbers/commons-numbers-angle/javadocs/api-1.0/index.html"/>
<item name="Javadoc (1.0-beta1 release)"
diff --git a/commons-numbers-arrays/pom.xml b/commons-numbers-arrays/pom.xml
index 3a7ceb8b..2d86e9a1 100644
--- a/commons-numbers-arrays/pom.xml
+++ b/commons-numbers-arrays/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-arrays</artifactId>
diff --git a/commons-numbers-arrays/src/site/site.xml b/commons-numbers-arrays/src/site/site.xml
index f4ea4ce9..82974642 100644
--- a/commons-numbers-arrays/src/site/site.xml
+++ b/commons-numbers-arrays/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.1 release)"
+ href="http://commons.apache.org/numbers/commons-numbers-arrays/javadocs/api-1.1/index.html"/>
<item name="Javadoc (1.0 release)"
href="http://commons.apache.org/numbers/commons-numbers-arrays/javadocs/api-1.0/index.html"/>
<item name="Javadoc (1.0-beta1 release)"
diff --git a/commons-numbers-bom/pom.xml b/commons-numbers-bom/pom.xml
index 60e64cd9..ab8950c6 100644
--- a/commons-numbers-bom/pom.xml
+++ b/commons-numbers-bom/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-bom</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
<name>Apache Commons Numbers (Bill of Materials)</name>
<packaging>pom</packaging>
diff --git a/commons-numbers-combinatorics/pom.xml b/commons-numbers-combinatorics/pom.xml
index 4eb8bfa4..223480b1 100644
--- a/commons-numbers-combinatorics/pom.xml
+++ b/commons-numbers-combinatorics/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-combinatorics</artifactId>
diff --git a/commons-numbers-combinatorics/src/site/site.xml b/commons-numbers-combinatorics/src/site/site.xml
index 0d968268..1bd05daf 100644
--- a/commons-numbers-combinatorics/src/site/site.xml
+++ b/commons-numbers-combinatorics/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.1 release)"
+ href="http://commons.apache.org/numbers/commons-numbers-combinatorics/javadocs/api-1.1/index.html"/>
<item name="Javadoc (1.0 release)"
href="http://commons.apache.org/numbers/commons-numbers-combinatorics/javadocs/api-1.0/index.html"/>
<item name="Javadoc (1.0-beta1 release)"
diff --git a/commons-numbers-complex-streams/pom.xml b/commons-numbers-complex-streams/pom.xml
index 994797ae..1c57118e 100644
--- a/commons-numbers-complex-streams/pom.xml
+++ b/commons-numbers-complex-streams/pom.xml
@@ -23,7 +23,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-complex-streams</artifactId>
diff --git a/commons-numbers-complex/pom.xml b/commons-numbers-complex/pom.xml
index dcc7c230..11b7b6f1 100644
--- a/commons-numbers-complex/pom.xml
+++ b/commons-numbers-complex/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-complex</artifactId>
diff --git a/commons-numbers-complex/src/site/site.xml b/commons-numbers-complex/src/site/site.xml
index 7cddab35..d02437fb 100644
--- a/commons-numbers-complex/src/site/site.xml
+++ b/commons-numbers-complex/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.1 release)"
+ href="http://commons.apache.org/numbers/commons-numbers-complex/javadocs/api-1.1/index.html"/>
<item name="Javadoc (1.0 release)"
href="http://commons.apache.org/numbers/commons-numbers-complex/javadocs/api-1.0/index.html"/>
<item name="Javadoc (1.0-beta1 release)"
diff --git a/commons-numbers-core/pom.xml b/commons-numbers-core/pom.xml
index 488f8715..bd449875 100644
--- a/commons-numbers-core/pom.xml
+++ b/commons-numbers-core/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-core</artifactId>
diff --git a/commons-numbers-core/src/site/site.xml b/commons-numbers-core/src/site/site.xml
index 96513336..409ad3eb 100644
--- a/commons-numbers-core/src/site/site.xml
+++ b/commons-numbers-core/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.1 release)"
+ href="http://commons.apache.org/numbers/commons-numbers-core/javadocs/api-1.1/index.html"/>
<item name="Javadoc (1.0 release)"
href="http://commons.apache.org/numbers/commons-numbers-core/javadocs/api-1.0/index.html"/>
<item name="Javadoc (1.0-beta1 release)"
diff --git a/commons-numbers-docs/pom.xml b/commons-numbers-docs/pom.xml
index edb1fd62..b52fe188 100644
--- a/commons-numbers-docs/pom.xml
+++ b/commons-numbers-docs/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-docs</artifactId>
@@ -57,59 +57,59 @@
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-angle</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-arrays</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-combinatorics</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-complex</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-core</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-field</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-fraction</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-gamma</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-primes</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-quaternion</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-rootfinder</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</dependency>
- </dependencies >
+ </dependencies>
<build>
<sourceDirectory>src</sourceDirectory>
diff --git a/commons-numbers-examples/examples-jmh/pom.xml b/commons-numbers-examples/examples-jmh/pom.xml
index ff219a39..ab519301 100644
--- a/commons-numbers-examples/examples-jmh/pom.xml
+++ b/commons-numbers-examples/examples-jmh/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-examples</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-examples-jmh</artifactId>
diff --git a/commons-numbers-examples/pom.xml b/commons-numbers-examples/pom.xml
index e20d3052..4da22327 100644
--- a/commons-numbers-examples/pom.xml
+++ b/commons-numbers-examples/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-examples</artifactId>
diff --git a/commons-numbers-field/pom.xml b/commons-numbers-field/pom.xml
index d3c20a0d..09933a61 100644
--- a/commons-numbers-field/pom.xml
+++ b/commons-numbers-field/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-field</artifactId>
diff --git a/commons-numbers-field/src/site/site.xml b/commons-numbers-field/src/site/site.xml
index bfdbc9c1..f1aab286 100644
--- a/commons-numbers-field/src/site/site.xml
+++ b/commons-numbers-field/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.1 release)"
+ href="http://commons.apache.org/numbers/commons-numbers-field/javadocs/api-1.1/index.html"/>
<item name="Javadoc (1.0 release)"
href="http://commons.apache.org/numbers/commons-numbers-field/javadocs/api-1.0/index.html"/>
<item name="Javadoc (1.0-beta1 release)"
diff --git a/commons-numbers-fraction/pom.xml b/commons-numbers-fraction/pom.xml
index 732b2cb2..2adf5efa 100644
--- a/commons-numbers-fraction/pom.xml
+++ b/commons-numbers-fraction/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-fraction</artifactId>
diff --git a/commons-numbers-fraction/src/site/site.xml b/commons-numbers-fraction/src/site/site.xml
index c9866cb6..e51f5834 100644
--- a/commons-numbers-fraction/src/site/site.xml
+++ b/commons-numbers-fraction/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.1 release)"
+ href="http://commons.apache.org/numbers/commons-numbers-fraction/javadocs/api-1.1/index.html"/>
<item name="Javadoc (1.0 release)"
href="http://commons.apache.org/numbers/commons-numbers-fraction/javadocs/api-1.0/index.html"/>
<item name="Javadoc (1.0-beta1 release)"
diff --git a/commons-numbers-gamma/pom.xml b/commons-numbers-gamma/pom.xml
index d02769d1..5ce3fb0d 100644
--- a/commons-numbers-gamma/pom.xml
+++ b/commons-numbers-gamma/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-gamma</artifactId>
diff --git a/commons-numbers-gamma/src/site/site.xml b/commons-numbers-gamma/src/site/site.xml
index db5ac5c1..d5f5fbe2 100644
--- a/commons-numbers-gamma/src/site/site.xml
+++ b/commons-numbers-gamma/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.1 release)"
+ href="http://commons.apache.org/numbers/commons-numbers-gamma/javadocs/api-1.1/index.html"/>
<item name="Javadoc (1.0 release)"
href="http://commons.apache.org/numbers/commons-numbers-gamma/javadocs/api-1.0/index.html"/>
<item name="Javadoc (1.0-beta1 release)"
diff --git a/commons-numbers-primes/pom.xml b/commons-numbers-primes/pom.xml
index d617bc21..76e2de4b 100644
--- a/commons-numbers-primes/pom.xml
+++ b/commons-numbers-primes/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-primes</artifactId>
diff --git a/commons-numbers-primes/src/site/site.xml b/commons-numbers-primes/src/site/site.xml
index 31866df5..1f39d2e2 100644
--- a/commons-numbers-primes/src/site/site.xml
+++ b/commons-numbers-primes/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.1 release)"
+ href="http://commons.apache.org/numbers/commons-numbers-primes/javadocs/api-1.1/index.html"/>
<item name="Javadoc (1.0 release)"
href="http://commons.apache.org/numbers/commons-numbers-primes/javadocs/api-1.0/index.html"/>
<item name="Javadoc (1.0-beta1 release)"
diff --git a/commons-numbers-quaternion/pom.xml b/commons-numbers-quaternion/pom.xml
index c9167a60..3fa10d5f 100644
--- a/commons-numbers-quaternion/pom.xml
+++ b/commons-numbers-quaternion/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-quaternion</artifactId>
diff --git a/commons-numbers-quaternion/src/site/site.xml b/commons-numbers-quaternion/src/site/site.xml
index d842ec6c..699cd872 100644
--- a/commons-numbers-quaternion/src/site/site.xml
+++ b/commons-numbers-quaternion/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.1 release)"
+ href="http://commons.apache.org/numbers/commons-numbers-quaternion/javadocs/api-1.1/index.html"/>
<item name="Javadoc (1.0 release)"
href="http://commons.apache.org/numbers/commons-numbers-quaternion/javadocs/api-1.0/index.html"/>
<item name="Javadoc (1.0-beta1 release)"
diff --git a/commons-numbers-rootfinder/pom.xml b/commons-numbers-rootfinder/pom.xml
index c507f572..01b5ccec 100644
--- a/commons-numbers-rootfinder/pom.xml
+++ b/commons-numbers-rootfinder/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers-rootfinder</artifactId>
diff --git a/commons-numbers-rootfinder/src/site/site.xml b/commons-numbers-rootfinder/src/site/site.xml
index ab8caccb..48ec5ada 100644
--- a/commons-numbers-rootfinder/src/site/site.xml
+++ b/commons-numbers-rootfinder/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.1 release)"
+ href="http://commons.apache.org/numbers/commons-numbers-rootfinder/javadocs/api-1.1/index.html"/>
<item name="Javadoc (1.0 release)"
href="http://commons.apache.org/numbers/commons-numbers-rootfinder/javadocs/api-1.0/index.html"/>
<item name="Javadoc (1.0-beta1 release)"
diff --git a/dist-archive/pom.xml b/dist-archive/pom.xml
index 0906edcc..deeb9514 100644
--- a/dist-archive/pom.xml
+++ b/dist-archive/pom.xml
@@ -17,15 +17,13 @@ KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
-<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">
+<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-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
</parent>
<artifactId>commons-numbers</artifactId>
@@ -41,8 +39,8 @@ under the License.
<commons.siteOutputDirectory>${basedir}/../target/site</commons.siteOutputDirectory>
<commons.releaseNotesLocation>${basedir}/../RELEASE-NOTES.txt</commons.releaseNotesLocation>
<commons.distSvnStagingUrl>scm:svn:https://dist.apache.org/repos/dist/dev/commons/${commons.componentid}</commons.distSvnStagingUrl>
- <commons.releaseManagerName>Matt Juntunen</commons.releaseManagerName>
- <commons.releaseManagerKey>7DD53AEFEDF1C3D392B51EBE346F4FCECFB70B1A</commons.releaseManagerKey>
+ <commons.releaseManagerName>Alex Herbert</commons.releaseManagerName>
+ <commons.releaseManagerKey>BC87A3FD0A54480F0BADBEBD21939FF0CA2A6567</commons.releaseManagerKey>
</properties>
<build>
diff --git a/pom.xml b/pom.xml
index 385e80af..54963b5c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -25,7 +25,7 @@
</parent>
<artifactId>commons-numbers-parent</artifactId>
- <version>1.1-SNAPSHOT</version>
+ <version>1.2-SNAPSHOT</version>
<packaging>pom</packaging>
<name>Apache Commons Numbers</name>
<description>The Apache Commons Numbers project provides number types and utilities.</description>
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index ce0dba1e..d745b9ce 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -52,13 +52,16 @@ If the output is not quite correct, check for invisible trailing spaces!
<title>Apache Commons Numbers Release Notes</title>
</properties>
<body>
- <release version="1.1" date="TBD" description="
+ <release version="1.1" date="2022-11-01" description="
New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires Java 8.
">
+ <action dev="aherbert" type="add" issue="NUMBERS-70">
+ Add a user guide.
+ </action>
<action dev="aherbert" type="add" issue="NUMBERS-190">
- Add a Bill of Materials (BOM) to aid in dependency management when referencing multiple
- Apache Commons Numbers artifacts. The BOM should be used to ensure all imported artifacts are
- compatible.
+ Add a Bill of Materials (BOM) to aid in dependency management when referencing
+ multiple Apache Commons Numbers artifacts. The BOM should be used to ensure all
+ imported artifacts are compatible.
</action>
<action dev="aherbert" type="fix" issue="NUMBERS-185">
"Precision": Allow Precision.compareTo using a maxUlps to be used for sorting.
@@ -88,7 +91,8 @@ New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires
"BrentSolver": Avoid overflow creating the initial value between the lower and upper.
</action>
<action dev="aherbert" type="add" issue="NUMBERS-177">
- "Erfcx": Compute a scaled complementary error function: erfcx(z) = erfc(z) * exp(z*z).
+ "Erfcx": Compute a scaled complementary error function:
+ erfcx(z) = erfc(z) * exp(z*z).
</action>
<action dev="aherbert" type="update" issue="NUMBERS-178">
"Factorial/FactorialDouble": Tabulate all factorials with exact 64-bit double
@@ -96,7 +100,8 @@ New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires
class and removes obsolete caching functionality.
</action>
<action dev="aherbert" type="update" issue="NUMBERS-176">
- "ContinuedFraction": Update to use a shared implementation with GeneralizedContinuedFraction.
+ "ContinuedFraction": Update to use a shared implementation with
+ GeneralizedContinuedFraction.
</action>
<action dev="aherbert" type="update" issue="NUMBERS-174">
"Gamma/LogGamma/RegularizedGamma": Update the gamma function implementations to
@@ -104,9 +109,9 @@ New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires
Functionality is ported from the Boost C++ library.
</action>
<action dev="aherbert" type="add" issue="NUMBERS-175">
- "GeneralizedContinuedFraction": A continued fraction class to compute using a generator.
- Allows evaluation of continued fractions from a regular series where coefficients can
- be computed iteratively from the previous coefficients.
+ "GeneralizedContinuedFraction": A continued fraction class to compute using a
+ generator. Allows evaluation of continued fractions from a regular series where
+ coefficients can be computed iteratively from the previous coefficients.
</action>
<action dev="aherbert" type="fix" issue="NUMBERS-173">
"ContinuedFraction": Set a minimum bound on the relative error epsilon. Prevents
diff --git a/RELEASE-NOTES.txt b/src/site/resources/release-notes/RELEASE-NOTES-1.1.txt
similarity index 54%
copy from RELEASE-NOTES.txt
copy to src/site/resources/release-notes/RELEASE-NOTES-1.1.txt
index b7f93984..2d8e52a9 100644
--- a/RELEASE-NOTES.txt
+++ b/src/site/resources/release-notes/RELEASE-NOTES-1.1.txt
@@ -1,4 +1,75 @@
+ Apache Commons Numbers 1.1 RELEASE NOTES
+
+The Apache Commons Numbers team is pleased to announce the release of
+commons-numbers-parent-1.1
+
+The Apache Commons Numbers project provides number types and utilities.
+
+New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires Java 8.
+
+Changes in this version include:
+
+New features:
+o NUMBERS-70: Add a user guide.
+o NUMBERS-190: Add a Bill of Materials (BOM) to aid in dependency management when referencing
+ multiple Apache Commons Numbers artifacts. The BOM should be used to ensure all
+ imported artifacts are compatible.
+o NUMBERS-181: Updated support for the beta functions. "RegularizedBeta": Added the
+ complement and derivative of the regularized beta function.
+ Added "IncompleteBeta" and "Beta" classes.
+ Functionality is ported from the Boost C++ library.
+o NUMBERS-180: "GammaRatio": Compute the ratio of two gamma functions.
+o NUMBERS-177: "Erfcx": Compute a scaled complementary error function:
+ erfcx(z) = erfc(z) * exp(z*z).
+o NUMBERS-175: "GeneralizedContinuedFraction": A continued fraction class to compute using a
+ generator. Allows evaluation of continued fractions from a regular series where
+ coefficients can be computed iteratively from the previous coefficients.
+
+Fixed Bugs:
+o NUMBERS-185: "Precision": Allow Precision.compareTo using a maxUlps to be used for sorting.
+ This corrects handling of NaN comparisons.
+o NUMBERS-182: "LogBeta": Avoid overflow for tiny arguments.
+o "BrentSolver": Avoid overflow creating the initial value between the lower and upper.
+o NUMBERS-173: "ContinuedFraction": Set a minimum bound on the relative error epsilon. Prevents
+ an infinite loop when the epsilon is zero.
+o "FactorialDouble": Prevent caching values that are infinite. The cache will support
+ factorials up to 170.
+o NUMBERS-170: "RegularizedBeta": Detect edge cases for arguments that can be evaluated by
+ exploiting properties of the regularized beta function.
+o NUMBERS-168: "BrentSolver": Identify brackets with small objective values.
+o Fix wrong javadoc. Thanks to Arturo Bernal.
+
+Changes:
+o NUMBERS-184: "Precision": Reduce number of operations in Precision.equals using a maxUlps.
+o NUMBERS-183: Improve the binomial coefficient classes. Avoid recursive method calls.
+ Avoid overflow for BinomialCoefficientDouble for large results close to infinity.
+ Use precomputed factorials and the LogBeta function for efficiency.
+o NUMBERS-178: "Factorial/FactorialDouble": Tabulate all factorials with exact 64-bit double
+ representations of n! up to n=170. This change deprecates the FactorialDouble
+ class and removes obsolete caching functionality.
+o NUMBERS-176: "ContinuedFraction": Update to use a shared implementation with
+ GeneralizedContinuedFraction.
+o NUMBERS-174: "Gamma/LogGamma/RegularizedGamma": Update the gamma function implementations to
+ increase accuracy and support for extreme values.
+ Functionality is ported from the Boost C++ library.
+o NUMBERS-172: "Erf/Erfc": Use a rational function approximation accurate to 53-bits of precision.
+ This replaces the use of the regularized gamma functions P and Q and increases accuracy
+ at extreme limits of the function. Execution speed is improved.
+ Functionality is ported from the Boost C++ library.
+o NUMBERS-171: "InverseErfc": Support full range of [0, 2]. This lowers the supported
+ minimum value from 2^-53 to double min value. Execution speed is improved.
+ Functionality is ported from the Boost C++ library.
+
+
+For complete information on Apache Commons Numbers, including instructions on how to submit bug
+reports, patches, or suggestions for improvement, see the Apache Commons Numbers website:
+
+http://commons.apache.org/proper/commons-numbers/
+
+
+=============================================================================
+
Apache Commons Numbers 1.0 RELEASE NOTES
The Apache Commons Numbers team is pleased to announce the release of
diff --git a/src/site/xdoc/download_numbers.xml b/src/site/xdoc/download_numbers.xml
index 8ef0aca7..5fd700be 100644
--- a/src/site/xdoc/download_numbers.xml
+++ b/src/site/xdoc/download_numbers.xml
@@ -113,32 +113,32 @@ limitations under the License.
</p>
</subsection>
</section>
- <section name="Apache Commons Numbers 1.0 (requires Java 8+)">
+ <section name="Apache Commons Numbers 1.1 (requires Java 8+)">
<subsection name="Binaries">
<table>
<tr>
- <td><a href="[preferred]/commons/numbers/binaries/commons-numbers-1.0-bin.tar.gz">commons-numbers-1.0-bin.tar.gz</a></td>
- <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-bin.tar.gz.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-bin.tar.gz.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/numbers/binaries/commons-numbers-1.1-bin.tar.gz">commons-numbers-1.1-bin.tar.gz</a></td>
+ <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.1-bin.tar.gz.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.1-bin.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a href="[preferred]/commons/numbers/binaries/commons-numbers-1.0-bin.zip">commons-numbers-1.0-bin.zip</a></td>
- <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-bin.zip.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-bin.zip.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/numbers/binaries/commons-numbers-1.1-bin.zip">commons-numbers-1.1-bin.zip</a></td>
+ <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.1-bin.zip.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.1-bin.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
- <td><a href="[preferred]/commons/numbers/source/commons-numbers-1.0-src.tar.gz">commons-numbers-1.0-src.tar.gz</a></td>
- <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-src.tar.gz.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-src.tar.gz.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/numbers/source/commons-numbers-1.1-src.tar.gz">commons-numbers-1.1-src.tar.gz</a></td>
+ <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.1-src.tar.gz.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.1-src.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a href="[preferred]/commons/numbers/source/commons-numbers-1.0-src.zip">commons-numbers-1.0-src.zip</a></td>
- <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-src.zip.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-src.zip.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/numbers/source/commons-numbers-1.1-src.zip">commons-numbers-1.1-src.zip</a></td>
+ <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.1-src.zip.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.1-src.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
diff --git a/src/site/xdoc/release-history.xml b/src/site/xdoc/release-history.xml
index 24f7b478..e5c425ad 100644
--- a/src/site/xdoc/release-history.xml
+++ b/src/site/xdoc/release-history.xml
@@ -24,6 +24,9 @@ limitations under the License.
<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-11-01</td><td>8+</td><td><a href="release-notes/RELEASE-NOTES-1.1.txt">release notes for 1.1</a></td>
+ </tr>
<tr>
<td>1.0</td><td>2021-07-17</td><td>8+</td><td><a href="release-notes/RELEASE-NOTES-1.0.txt">release notes for 1.0</a></td>
</tr>