This is an automated email from the ASF dual-hosted git repository. mattjuntunen pushed a commit to annotated tag commons-numbers-1.0-rc1 in repository https://gitbox.apache.org/repos/asf/commons-numbers.git
commit 68035ca88f38bbba599196a70dd280511bc758c6 Author: Matt Juntunen <mattjuntu...@apache.org> AuthorDate: Sun Jul 11 11:43:19 2021 -0400 Release candidate --- 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-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-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 | 2 +- pom.xml | 9 +- src/changes/changes.xml | 8 +- .../resources/release-notes/RELEASE-NOTES-1.0.txt | 100 +++++++++++++++++++++ src/site/xdoc/download_numbers.xml | 26 +++--- src/site/xdoc/release-history.xml | 3 + 32 files changed, 231 insertions(+), 38 deletions(-) diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index 9cdd9f6..b7f9398 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,4 +1,72 @@ + Apache Commons Numbers 1.0 RELEASE NOTES + +The Apache Commons Numbers team is pleased to announce the release of +commons-numbers-parent-1.0 + +The Apache Commons Numbers project provides number types and utilities. + +This is the first official release of Apache Commons Numbers. + +Apache Commons Numbers 1.0 contains the following library modules: + commons-numbers-angle (requires Java 8+) + commons-numbers-arrays (requires Java 8+) + commons-numbers-combinatorics (requires Java 8+) + commons-numbers-complex (requires Java 8+) + commons-numbers-core (requires Java 8+) + commons-numbers-field (requires Java 8+) + commons-numbers-fraction (requires Java 8+) + commons-numbers-gamma (requires Java 8+) + commons-numbers-primes (requires Java 8+) + commons-numbers-quaternion (requires Java 8+) + commons-numbers-rootfinder (requires Java 8+) +N.B. the Performance testing module requires Java 9+. (The unit tests require Java 8+) + +Changes in this version include: + + +Fixed Bugs: +o NUMBERS-153: Use iterative implementation of "trigamma" function. Thanks to Dmitriy Golovashkin + for reporting. Thanks to Gilles Sadowski. +o NUMBERS-150: "Fraction/BigFraction": Fixed pow(int) to handle Integer.MIN_VALUE and throw + ArithmeticException for negative exponents to a fraction of zero. Thanks to Jin Xu. +o NUMBERS-147: Fixed Fraction/BigFraction from(double, int) to support Integer.MIN_VALUE as max + denominator. Thanks to Alex Herbert. + +Changes: +o NUMBERS-163: Combined "LinearCombination" and "Summation" into single "Sum" class. Thanks to + Matt Juntunen. +o NUMBERS-164: Added SortInPlace utility, original from Commons Math. Thanks to Gilles Sadowski. +o NUMBERS-159: Moved "Norms", "LinearCombination", and "Summation" from commons-numbers-arrays + module to commons-numbers-core module. Moved "CosAngle" from commons-numbers-arrays module + to commons-numbers-angle module. Thanks to Matt Juntunen. +o NUMBERS-156: Replaced "SafeNorm" with "Norms". Added "Summation" class for extended precision + summation. Thanks to Matt Juntunen. +o NUMBERS-161: "Angle" replaces "PlaneAngle" and "PlaneAngleRadians". Thanks to Gilles Sadowski. +o NUMBERS-158: Replace angle normalize method with normalizer method that returns operator + instance. Thanks to Gilles Sadowski. +o NUMBERS-157: Adding Reduce operation originally from Commons Math to commons-numbers-angle + module. Thanks to Gilles Sadowski. +o NUMBERS-142: "LinearCombination": Update to use the dot2s algorithm. Avoids construction of an + intermediate array for array dot products. Update the hi-lo splitting algorithm + to use Dekker's split to ensure the product round-off is computed to exact precision. + Thanks to Alex Herbert. +o NUMBERS-154: Precision compareTo method now handles NaN properly to ensure consistent sorting. + Thanks to Gilles Sadowski. +o NUMBERS-149: "Fraction": Port tests from commons-lang Fraction to demonstrate functional + compatibility between the lang and numbers implementation of Fraction. Thanks to Jin Xu. +o NUMBERS-151: "ArithmeticUtils": Refine pow(int, int) and pow(long, int) for edge cases. + Thanks to Jin Xu. + + +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-beta1 RELEASE NOTES The Apache Commons Numbers team is pleased to announce the release of @@ -22,9 +90,6 @@ Apache Commons Numbers 1.0-beta1 contains the following library modules: commons-numbers-quaternion (requires Java 8+) commons-numbers-rootfinder (requires Java 8+) -N.B. the Performance testing module requires Java 9+. -(The unit tests require Java 8+) - No changes defined in this version. For complete information on Apache Commons Numbers, including instructions on how to submit bug diff --git a/commons-numbers-angle/pom.xml b/commons-numbers-angle/pom.xml index cd5ed18..456c0d5 100644 --- a/commons-numbers-angle/pom.xml +++ b/commons-numbers-angle/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</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 9a9b849..88dd73a 100644 --- a/commons-numbers-angle/src/site/site.xml +++ b/commons-numbers-angle/src/site/site.xml @@ -27,6 +27,8 @@ <item name="Overview" href="index.html"/> <item name="Latest API docs (development)" href="apidocs/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)" href="http://commons.apache.org/numbers/commons-numbers-angle/javadocs/api-1.0-beta1/index.html"/> </menu> diff --git a/commons-numbers-arrays/pom.xml b/commons-numbers-arrays/pom.xml index 756b76f..65d7de5 100644 --- a/commons-numbers-arrays/pom.xml +++ b/commons-numbers-arrays/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</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 0480cf6..5efbefb 100644 --- a/commons-numbers-arrays/src/site/site.xml +++ b/commons-numbers-arrays/src/site/site.xml @@ -27,6 +27,8 @@ <item name="Overview" href="index.html"/> <item name="Latest API docs (development)" href="apidocs/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)" href="http://commons.apache.org/numbers/commons-numbers-arrays/javadocs/api-1.0-beta1/index.html"/> </menu> diff --git a/commons-numbers-combinatorics/pom.xml b/commons-numbers-combinatorics/pom.xml index 13c96d1..0c66b4e 100644 --- a/commons-numbers-combinatorics/pom.xml +++ b/commons-numbers-combinatorics/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</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 e1df561..0f1fd2d 100644 --- a/commons-numbers-combinatorics/src/site/site.xml +++ b/commons-numbers-combinatorics/src/site/site.xml @@ -27,6 +27,8 @@ <item name="Overview" href="index.html"/> <item name="Latest API docs (development)" href="apidocs/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)" href="http://commons.apache.org/numbers/commons-numbers-combinatorics/javadocs/api-1.0-beta1/index.html"/> </menu> diff --git a/commons-numbers-complex-streams/pom.xml b/commons-numbers-complex-streams/pom.xml index 624e118..4478fca 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.0-SNAPSHOT</version> + <version>1.0</version> </parent> <artifactId>commons-numbers-complex-streams</artifactId> diff --git a/commons-numbers-complex/pom.xml b/commons-numbers-complex/pom.xml index de954b0..03d8deb 100644 --- a/commons-numbers-complex/pom.xml +++ b/commons-numbers-complex/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</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 23081d2..b7bd19e 100644 --- a/commons-numbers-complex/src/site/site.xml +++ b/commons-numbers-complex/src/site/site.xml @@ -27,6 +27,8 @@ <item name="Overview" href="index.html"/> <item name="Latest API docs (development)" href="apidocs/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)" href="http://commons.apache.org/numbers/commons-numbers-complex/javadocs/api-1.0-beta1/index.html"/> </menu> diff --git a/commons-numbers-core/pom.xml b/commons-numbers-core/pom.xml index 412fc8a..29d3a54 100644 --- a/commons-numbers-core/pom.xml +++ b/commons-numbers-core/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</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 7ce9690..2d099c7 100644 --- a/commons-numbers-core/src/site/site.xml +++ b/commons-numbers-core/src/site/site.xml @@ -27,6 +27,8 @@ <item name="Overview" href="index.html"/> <item name="Latest API docs (development)" href="apidocs/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)" href="http://commons.apache.org/numbers/commons-numbers-core/javadocs/api-1.0-beta1/index.html"/> </menu> diff --git a/commons-numbers-examples/examples-jmh/pom.xml b/commons-numbers-examples/examples-jmh/pom.xml index 73771cc..f345660 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.0-SNAPSHOT</version> + <version>1.0</version> </parent> <artifactId>commons-numbers-examples-jmh</artifactId> diff --git a/commons-numbers-examples/pom.xml b/commons-numbers-examples/pom.xml index 8366c4d..a7a2086 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.0-SNAPSHOT</version> + <version>1.0</version> </parent> <artifactId>commons-numbers-examples</artifactId> diff --git a/commons-numbers-field/pom.xml b/commons-numbers-field/pom.xml index 32c74fd..4a4ac90 100644 --- a/commons-numbers-field/pom.xml +++ b/commons-numbers-field/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</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 949ea54..e46aa33 100644 --- a/commons-numbers-field/src/site/site.xml +++ b/commons-numbers-field/src/site/site.xml @@ -27,6 +27,8 @@ <item name="Overview" href="index.html"/> <item name="Latest API docs (development)" href="apidocs/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)" href="http://commons.apache.org/numbers/commons-numbers-field/javadocs/api-1.0-beta1/index.html"/> </menu> diff --git a/commons-numbers-fraction/pom.xml b/commons-numbers-fraction/pom.xml index 9eb8526..966fa97 100644 --- a/commons-numbers-fraction/pom.xml +++ b/commons-numbers-fraction/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</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 cdf7c94..aa59d6e 100644 --- a/commons-numbers-fraction/src/site/site.xml +++ b/commons-numbers-fraction/src/site/site.xml @@ -27,6 +27,8 @@ <item name="Overview" href="index.html"/> <item name="Latest API docs (development)" href="apidocs/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)" href="http://commons.apache.org/numbers/commons-numbers-fraction/javadocs/api-1.0-beta1/index.html"/> </menu> diff --git a/commons-numbers-gamma/pom.xml b/commons-numbers-gamma/pom.xml index c067b5c..fa06666 100644 --- a/commons-numbers-gamma/pom.xml +++ b/commons-numbers-gamma/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</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 d6ea626..b6c9fcc 100644 --- a/commons-numbers-gamma/src/site/site.xml +++ b/commons-numbers-gamma/src/site/site.xml @@ -27,6 +27,8 @@ <item name="Overview" href="index.html"/> <item name="Latest API docs (development)" href="apidocs/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)" href="http://commons.apache.org/numbers/commons-numbers-gamma/javadocs/api-1.0-beta1/index.html"/> </menu> diff --git a/commons-numbers-primes/pom.xml b/commons-numbers-primes/pom.xml index d466f76..06274a5 100644 --- a/commons-numbers-primes/pom.xml +++ b/commons-numbers-primes/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</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 4c91c2b..f9f05d4 100644 --- a/commons-numbers-primes/src/site/site.xml +++ b/commons-numbers-primes/src/site/site.xml @@ -27,6 +27,8 @@ <item name="Overview" href="index.html"/> <item name="Latest API docs (development)" href="apidocs/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)" href="http://commons.apache.org/numbers/commons-numbers-primes/javadocs/api-1.0-beta1/index.html"/> </menu> diff --git a/commons-numbers-quaternion/pom.xml b/commons-numbers-quaternion/pom.xml index 50596b8..5fea5dd 100644 --- a/commons-numbers-quaternion/pom.xml +++ b/commons-numbers-quaternion/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</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 41b6406..94eee6f 100644 --- a/commons-numbers-quaternion/src/site/site.xml +++ b/commons-numbers-quaternion/src/site/site.xml @@ -27,6 +27,8 @@ <item name="Overview" href="index.html"/> <item name="Latest API docs (development)" href="apidocs/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)" href="http://commons.apache.org/numbers/commons-numbers-quaternion/javadocs/api-1.0-beta1/index.html"/> </menu> diff --git a/commons-numbers-rootfinder/pom.xml b/commons-numbers-rootfinder/pom.xml index 8a4b69e..bf0961f 100644 --- a/commons-numbers-rootfinder/pom.xml +++ b/commons-numbers-rootfinder/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</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 622222e..d34ec10 100644 --- a/commons-numbers-rootfinder/src/site/site.xml +++ b/commons-numbers-rootfinder/src/site/site.xml @@ -27,6 +27,8 @@ <item name="Overview" href="index.html"/> <item name="Latest API docs (development)" href="apidocs/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)" href="http://commons.apache.org/numbers/commons-numbers-rootfinder/javadocs/api-1.0-beta1/index.html"/> </menu> diff --git a/dist-archive/pom.xml b/dist-archive/pom.xml index 86f2c91..3b44f61 100644 --- a/dist-archive/pom.xml +++ b/dist-archive/pom.xml @@ -25,7 +25,7 @@ under the License. <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</version> </parent> <artifactId>commons-numbers</artifactId> diff --git a/pom.xml b/pom.xml index 76ededa..ff22eaf 100644 --- a/pom.xml +++ b/pom.xml @@ -25,7 +25,7 @@ </parent> <artifactId>commons-numbers-parent</artifactId> - <version>1.0-SNAPSHOT</version> + <version>1.0</version> <packaging>pom</packaging> <name>Apache Commons Numbers</name> <description>The Apache Commons Numbers project provides number types and utilities.</description> @@ -45,7 +45,7 @@ <!-- OSGi --> <commons.osgi.export>org.apache.commons.numbers</commons.osgi.export> <!-- do not use snapshot suffix here --> - <commons.release.version>1.0-beta1</commons.release.version> + <commons.release.version>1.0</commons.release.version> <commons.release.desc>(requires Java 8+)</commons.release.desc> <commons.rc.version>RC1</commons.rc.version> <commons.binary.suffix>-bin</commons.binary.suffix> @@ -687,6 +687,11 @@ <id>aherbert</id> <email>aherbert at apache dot org</email> </developer> + <developer> + <name>Matt Juntunen</name> + <id>mattjuntunen</id> + <email>mattjuntunen at apache dot org</email> + </developer> </developers> <contributors> diff --git a/src/changes/changes.xml b/src/changes/changes.xml index b4a3eae..43c4700 100644 --- a/src/changes/changes.xml +++ b/src/changes/changes.xml @@ -50,12 +50,10 @@ If the output is not quite correct, check for invisible trailing spaces! <title>Apache Commons Numbers Release Notes</title> </properties> <body> - <release version="1.0-beta2" date="TBD" description=" -This is a beta release of Apache Commons Numbers. No guarantees are -made regarding the stability of the API or compatibility with future -releases. + <release version="1.0" date="2021-07-17" description=" +This is the first official release of Apache Commons Numbers. -Apache Commons Numbers 1.0-beta1 contains the following library modules: +Apache Commons Numbers 1.0 contains the following library modules: commons-numbers-angle (requires Java 8+) commons-numbers-arrays (requires Java 8+) commons-numbers-combinatorics (requires Java 8+) 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..b7f9398 --- /dev/null +++ b/src/site/resources/release-notes/RELEASE-NOTES-1.0.txt @@ -0,0 +1,100 @@ + + Apache Commons Numbers 1.0 RELEASE NOTES + +The Apache Commons Numbers team is pleased to announce the release of +commons-numbers-parent-1.0 + +The Apache Commons Numbers project provides number types and utilities. + +This is the first official release of Apache Commons Numbers. + +Apache Commons Numbers 1.0 contains the following library modules: + commons-numbers-angle (requires Java 8+) + commons-numbers-arrays (requires Java 8+) + commons-numbers-combinatorics (requires Java 8+) + commons-numbers-complex (requires Java 8+) + commons-numbers-core (requires Java 8+) + commons-numbers-field (requires Java 8+) + commons-numbers-fraction (requires Java 8+) + commons-numbers-gamma (requires Java 8+) + commons-numbers-primes (requires Java 8+) + commons-numbers-quaternion (requires Java 8+) + commons-numbers-rootfinder (requires Java 8+) +N.B. the Performance testing module requires Java 9+. (The unit tests require Java 8+) + +Changes in this version include: + + +Fixed Bugs: +o NUMBERS-153: Use iterative implementation of "trigamma" function. Thanks to Dmitriy Golovashkin + for reporting. Thanks to Gilles Sadowski. +o NUMBERS-150: "Fraction/BigFraction": Fixed pow(int) to handle Integer.MIN_VALUE and throw + ArithmeticException for negative exponents to a fraction of zero. Thanks to Jin Xu. +o NUMBERS-147: Fixed Fraction/BigFraction from(double, int) to support Integer.MIN_VALUE as max + denominator. Thanks to Alex Herbert. + +Changes: +o NUMBERS-163: Combined "LinearCombination" and "Summation" into single "Sum" class. Thanks to + Matt Juntunen. +o NUMBERS-164: Added SortInPlace utility, original from Commons Math. Thanks to Gilles Sadowski. +o NUMBERS-159: Moved "Norms", "LinearCombination", and "Summation" from commons-numbers-arrays + module to commons-numbers-core module. Moved "CosAngle" from commons-numbers-arrays module + to commons-numbers-angle module. Thanks to Matt Juntunen. +o NUMBERS-156: Replaced "SafeNorm" with "Norms". Added "Summation" class for extended precision + summation. Thanks to Matt Juntunen. +o NUMBERS-161: "Angle" replaces "PlaneAngle" and "PlaneAngleRadians". Thanks to Gilles Sadowski. +o NUMBERS-158: Replace angle normalize method with normalizer method that returns operator + instance. Thanks to Gilles Sadowski. +o NUMBERS-157: Adding Reduce operation originally from Commons Math to commons-numbers-angle + module. Thanks to Gilles Sadowski. +o NUMBERS-142: "LinearCombination": Update to use the dot2s algorithm. Avoids construction of an + intermediate array for array dot products. Update the hi-lo splitting algorithm + to use Dekker's split to ensure the product round-off is computed to exact precision. + Thanks to Alex Herbert. +o NUMBERS-154: Precision compareTo method now handles NaN properly to ensure consistent sorting. + Thanks to Gilles Sadowski. +o NUMBERS-149: "Fraction": Port tests from commons-lang Fraction to demonstrate functional + compatibility between the lang and numbers implementation of Fraction. Thanks to Jin Xu. +o NUMBERS-151: "ArithmeticUtils": Refine pow(int, int) and pow(long, int) for edge cases. + Thanks to Jin Xu. + + +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-beta1 RELEASE NOTES + +The Apache Commons Numbers team is pleased to announce the release of +commons-numbers-parent-1.0-beta1 + +The Apache Commons Numbers project provides number types and utilities. + +This is a beta release of Apache Commons Numbers. No guarantees are made regarding the stability +of the API or compatibility with future releases. + +Apache Commons Numbers 1.0-beta1 contains the following library modules: + commons-numbers-angle (requires Java 8+) + commons-numbers-arrays (requires Java 8+) + commons-numbers-combinatorics (requires Java 8+) + commons-numbers-complex (requires Java 8+) + commons-numbers-core (requires Java 8+) + commons-numbers-field (requires Java 8+) + commons-numbers-fraction (requires Java 8+) + commons-numbers-gamma (requires Java 8+) + commons-numbers-primes (requires Java 8+) + commons-numbers-quaternion (requires Java 8+) + commons-numbers-rootfinder (requires Java 8+) + +No changes defined in this version. + +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/ + + diff --git a/src/site/xdoc/download_numbers.xml b/src/site/xdoc/download_numbers.xml index 69bb06d..8ef0aca 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-beta1 (requires Java 8+)"> + <section name="Apache Commons Numbers 1.0 (requires Java 8+)"> <subsection name="Binaries"> <table> <tr> - <td><a href="[preferred]/commons/numbers/binaries/commons-numbers-1.0-beta1-bin.tar.gz">commons-numbers-1.0-beta1-bin.tar.gz</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-beta1-bin.tar.gz.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-beta1-bin.tar.gz.asc">pgp</a></td> + <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> </tr> <tr> - <td><a href="[preferred]/commons/numbers/binaries/commons-numbers-1.0-beta1-bin.zip">commons-numbers-1.0-beta1-bin.zip</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-beta1-bin.zip.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-beta1-bin.zip.asc">pgp</a></td> + <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> </tr> </table> </subsection> <subsection name="Source"> <table> <tr> - <td><a href="[preferred]/commons/numbers/source/commons-numbers-1.0-beta1-src.tar.gz">commons-numbers-1.0-beta1-src.tar.gz</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-beta1-src.tar.gz.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-beta1-src.tar.gz.asc">pgp</a></td> + <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> </tr> <tr> - <td><a href="[preferred]/commons/numbers/source/commons-numbers-1.0-beta1-src.zip">commons-numbers-1.0-beta1-src.zip</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-beta1-src.zip.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-beta1-src.zip.asc">pgp</a></td> + <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> </tr> </table> </subsection> diff --git a/src/site/xdoc/release-history.xml b/src/site/xdoc/release-history.xml index 2d80f22..e56a758 100644 --- a/src/site/xdoc/release-history.xml +++ b/src/site/xdoc/release-history.xml @@ -25,6 +25,9 @@ limitations under the License. <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>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> + <tr> <td>1.0-beta1</td><td>2020-04-05</td><td>8+</td><td><a href="release-notes/RELEASE-NOTES-1.0-beta1.txt">release notes for 1.0-beta1</a></td> </tr> </table>