Author: aherbert
Date: Mon Oct 10 09:41:59 2022
New Revision: 57247
Log:
Release Commons RNG v1.5 (from RC1).
Added:
release/commons/rng/binaries/commons-rng-1.5-bin.tar.gz (with props)
release/commons/rng/binaries/commons-rng-1.5-bin.tar.gz.asc
release/commons/rng/binaries/commons-rng-1.5-bin.tar.gz.sha512
release/commons/rng/binaries/commons-rng-1.5-bin.zip (with props)
release/commons/rng/binaries/commons-rng-1.5-bin.zip.asc
release/commons/rng/binaries/commons-rng-1.5-bin.zip.sha512
release/commons/rng/source/commons-rng-1.5-src.tar.gz (with props)
release/commons/rng/source/commons-rng-1.5-src.tar.gz.asc
release/commons/rng/source/commons-rng-1.5-src.tar.gz.sha512
release/commons/rng/source/commons-rng-1.5-src.zip (with props)
release/commons/rng/source/commons-rng-1.5-src.zip.asc
release/commons/rng/source/commons-rng-1.5-src.zip.sha512
Removed:
release/commons/rng/binaries/commons-rng-1.4-bin.tar.gz
release/commons/rng/binaries/commons-rng-1.4-bin.tar.gz.asc
release/commons/rng/binaries/commons-rng-1.4-bin.tar.gz.sha512
release/commons/rng/binaries/commons-rng-1.4-bin.zip
release/commons/rng/binaries/commons-rng-1.4-bin.zip.asc
release/commons/rng/binaries/commons-rng-1.4-bin.zip.sha512
release/commons/rng/source/commons-rng-1.4-src.tar.gz
release/commons/rng/source/commons-rng-1.4-src.tar.gz.asc
release/commons/rng/source/commons-rng-1.4-src.tar.gz.sha512
release/commons/rng/source/commons-rng-1.4-src.zip
release/commons/rng/source/commons-rng-1.4-src.zip.asc
release/commons/rng/source/commons-rng-1.4-src.zip.sha512
Modified:
release/commons/rng/README.html
release/commons/rng/RELEASE-NOTES.txt
Modified: release/commons/rng/README.html
==============================================================================
--- release/commons/rng/README.html (original)
+++ release/commons/rng/README.html Mon Oct 10 09:41:59 2022
@@ -14,9 +14,9 @@
See the License for the specific language governing permissions and
limitations under the License.
-->
-<h1>Commons-RNG v1.4.</h1>
+<h1>Commons-RNG v1.5.</h1>
-<p>This is the 1.4 version of commons-rng. It is available in both binary and
source distributions.</p>
+<p>This is the 1.5 version of commons-rng. It is available in both binary and
source distributions.</p>
<p><font color="red" size="+2">Note:</font>
@@ -55,12 +55,12 @@
<pre>Always test available signatures, <i>e.g.</i>,
$ pgpk -a KEYS
-$ pgpv commons-rng-1.4-bin.tar.gz.asc
+$ pgpv commons-rng-1.5-bin.tar.gz.asc
or,
$ pgp -ka KEYS
-$ pgp commons-rng-1.4-bin.tar.gz.asc
+$ pgp commons-rng-1.5-bin.tar.gz.asc
or,
$ gpg --import KEYS
-$ gpg --verify commons-rng-1.4-bin.tar.gz.asc
+$ gpg --verify commons-rng-1.5-bin.tar.gz.asc
</pre>
<p>
\ No newline at end of file
Modified: release/commons/rng/RELEASE-NOTES.txt
==============================================================================
--- release/commons/rng/RELEASE-NOTES.txt (original)
+++ release/commons/rng/RELEASE-NOTES.txt Mon Oct 10 09:41:59 2022
@@ -1,4 +1,115 @@
+ Apache Commons RNG 1.5 RELEASE NOTES
+
+The Apache Commons RNG team is pleased to announce the release of Apache
Commons RNG 1.5
+
+The Apache Commons RNG project provides pure-Java implementation of
pseudo-random generators.
+
+This is a minor release of Apache Commons RNG, containing a
+few new features and performance improvements.
+
+Apache Commons RNG 1.5 contains the following library modules:
+ commons-rng-client-api (requires Java 8)
+ commons-rng-core (requires Java 8)
+ commons-rng-simple (requires Java 8)
+ commons-rng-sampling (requires Java 8)
+
+The code in module 'commons-rng-core' should not be accessed
+directly by applications as a future release might make use of
+the JPMS modularization feature available in Java 11+.
+
+Additional code is provided in the following modules:
+ commons-rng-examples-quadrature (requires Java 8)
+ commons-rng-examples-jmh (requires Java 8)
+ commons-rng-examples-sampling (requires Java 8)
+ commons-rng-examples-stress (requires Java 8)
+ commons-rng-examples-jpms (requires Java 11)
+
+It is however not part of the official API and no compatibility
+should be expected in subsequent releases.
+
+It must be noted that, due to the nature of random number generation, some
unit tests
+are bound to fail with some probability. The 'maven-surefire-plugin' is
configured
+to re-run tests that fail, and pass the build if they succeed within the
allotted
+number of reruns (the test will be marked as 'flaky' in the report).
+
+The source output type (int/long) of a RNG must maintain behavioural
compatibility
+between releases; derived types may break behavioural compatibility. Any
functional
+changes will be recorded in the release notes.
+
+Changes in this version include:
+
+New features:
+o RNG-182: Add a Bill of Materials (BOM) to aid in dependency management when
referencing multiple
+ Apache Commons RNG artifacts. The BOM should be used to ensure all
imported artifacts are
+ compatible.
+o RNG-181: LXM family to support SplittableUniformRandomProvider. This allows
creating a parallel
+ stream of generators which will avoid sequence correlations between
instances.
+o RNG-180: New "SplittableUniformRandomProvider" interface to allow splitting
a RNG into two
+ objects, each of which implements the same interface (and can be
recursively split
+ indefinitely). Add default methods to support parallel stream
implementations
+ of the UniformRandomProvider stream methods.
+o RNG-179: "FastLoadedDiceRollerDiscreteSampler": Distribution sampler that
uses the
+ Fast Loaded Dice Roller (FLDR) algorithm for exact sampling from a
discrete
+ probability distribution.
+o RNG-178: "JumpableUniformRandomProvider": Add support to generate Java 8
streams of new
+ random generator instances using the jump method.
+o RNG-176: "UniformRandomProvider": Enhance the interface with default
methods. Add range sample
+ methods with a lower and upper bound. Add support to generate Java
8 streams of sample
+ values. Note: This moves some method implementations from the core
module to the
+ client-api module. Binary compatibility is supported if the
versions of these modules are
+ matched. Users of the simple module should ensure the client-api
and core modules are
+ resolved as matched versions and not mismatched by transitive
dependency resolution.
+o RNG-177: "sampling": Add samples() method to the API to generate Java 8
streams of sample values.
+o RNG-168: New LXM family of random generators. Added implementations of the
LXM generators
+ included in JDK 17.
+o RNG-174: "RandomSource": Improve support for non-zero seeds. Seeding has
been changed to specify
+ a sub-range of the seed that must not be all zero. Introduces a
functional change where
+ byte[] seeds generated by RandomSource with a fixed
UniformRandomProvider may be
+ different. Seeds are now reproducible across calls using an input
random source in an
+ identical state.
+o RNG-173: "BaseProvider": Add a static method to extend input int[] and
long[] seeds to a
+ minimum length.
+o RNG-167: New "TSampler" class to sample from Student's t-distribution.
+
+Fixed Bugs:
+o RNG-175: "RandomSource.MSWS": createSeed(UniformRandomProvider) to handle a
bad RNG.
+ This fixes an infinite loop when the RNG output is not suitably
random to create a seed.
+o RNG-170: Update implementations of "UniformRandomProvider.nextBytes" with a
range
+ [start, start + length) to be consistent with the exception
conditions of the
+ JDK array range checks.
+o RNG-166: Update "LogNormalSampler" and "BoxMullerLogNormalSampler" to allow
a negative mean for
+ the natural logarithm of the distribution values.
+o RNG-165: "RejectionInversionZipfSampler": Allow a zero exponent in the Zipf
sampler.
+
+Changes:
+o RNG-171: Reduce the memory footprint of the cached boolean and int source
for the IntProvider
+ and LongProvider. This change has a performance improvement on some
JDKs.
+ Note: This introduces a functional compatibility change to the
output from the
+ nextInt method of any LongProvider; the output is now little-endian
as
+ each long is returned as the low 32-bits then the high 32-bits.
+ The bit output from nextBoolean is unchanged (little-endian order).
+o RNG-172: "UniformLongSampler": Precompute rejection threshold for a
non-power of 2 range.
+o RNG-169: "RandomSource.create": Update array seed conversion to use optimum
seed length.
+ Avoid duplication of input bytes and conversion of bytes that will
be discarded.
+ This introduces a behavioural change for int[], long[], and int
seed conversions.
+ Any fixed seeds used in previous versions in byte[], long or the
native seed type
+ will create the same RNG state. All array-to-array seed conversions
now use little
+ endian format, matching the byte[] conversion behaviour since 1.0.
All seed
+ conversions that expand the seed size use the same generation
method to provide
+ additional bytes. Conversion of int[] to long avoids loss of bits
+ changing the possible output seeds from 2^32 to 2^64.
+o RNG-160: "ZigguratSampler": Performance improvement using ternary operator
to sort values.
+
+
+For complete information on Apache Commons RNG, including instructions on how
to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons RNG website:
+
+https://commons.apache.org/proper/commons-rng/
+
+
+=============================================================================
+
Apache Commons RNG 1.4 RELEASE NOTES
The Apache Commons RNG team is pleased to announce the release of Apache
Commons RNG 1.4
Added: release/commons/rng/binaries/commons-rng-1.5-bin.tar.gz
==============================================================================
Binary file - no diff available.
Propchange: release/commons/rng/binaries/commons-rng-1.5-bin.tar.gz
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: release/commons/rng/binaries/commons-rng-1.5-bin.tar.gz.asc
==============================================================================
--- release/commons/rng/binaries/commons-rng-1.5-bin.tar.gz.asc (added)
+++ release/commons/rng/binaries/commons-rng-1.5-bin.tar.gz.asc Mon Oct 10
09:41:59 2022
@@ -0,0 +1,16 @@
+-----BEGIN PGP SIGNATURE-----
+
+iQIzBAABCgAdFiEEvIej/QpUSA8Lrb69IZOf8MoqZWcFAmM9SoUACgkQIZOf8Moq
+ZWeFSRAAl8u/WV7mXP/Hqdzuugfwlny2ydcaVGyaBohlqHikMJUdh3Br8LWFl1Nu
+15rMUWsoj3DEsPQoPOEUfXT0veF8wMM/gfla7D5nqrL2KNgShNtg+04ZXQ8DV3eG
+f7Zls8mgJSzYkFe89jZjHrWCsuALfrK3KloAEf6AZ2+bN2FEHpneCrMDYNCs2qkk
++hPUr6wl0BddzKbwyq5J6tC+b0jyV7AfR9TRD2bBQA+dLjgVmepEvRyL9PyHixFJ
+muNxX5+nwE+X1kWWw4RJHn6avQZ5GDH4Gl5E/c1xVy/k5C1PiivZmzwV3077RON3
+1f5ilLov9XeI5Fl6XQgg50ySLtuuToZsqCtwe4hiop4xPM5Z4PSg50sa2dvqDfeN
+STCoBhdPvHO+oCjdVMMCVDz4mbh4UAM7ThZXV/xxbIcjkRx8IRpBRHBYo2CW1Oy4
++vdgC+fSO28u+DBGGRiTzjqcLdsJq9pWcjmvgZSK8ydO91Tt2DrXjk91uvI3waBZ
+mVen/nprRvxwtLhK396usJ8PKx+BkmHQNJIvAdBWA1sps1jcLdO7gsJD4x7Ze5kN
+EVpBODYAVAw7nixqTNtbkY+by22/vw3mJE9OwinsvUHTlyoXrlF2dfURU6F/hyv1
+z+M7Z378VeaHlwYXgWSuvYVpdLxJtJVE5PiPZjPLFsG65nOoCmQ=
+=TU4P
+-----END PGP SIGNATURE-----
Added: release/commons/rng/binaries/commons-rng-1.5-bin.tar.gz.sha512
==============================================================================
--- release/commons/rng/binaries/commons-rng-1.5-bin.tar.gz.sha512 (added)
+++ release/commons/rng/binaries/commons-rng-1.5-bin.tar.gz.sha512 Mon Oct 10
09:41:59 2022
@@ -0,0 +1 @@
+9e98092cb123a1873cc4ab05ebd87681b9f5fe171ad53cd00488c33e0ab2c7fb8a0bdd9c903a3bde7bc2e4f4035b07cf223b0d921e35d00fcea226ec16f86b5c
Added: release/commons/rng/binaries/commons-rng-1.5-bin.zip
==============================================================================
Binary file - no diff available.
Propchange: release/commons/rng/binaries/commons-rng-1.5-bin.zip
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: release/commons/rng/binaries/commons-rng-1.5-bin.zip.asc
==============================================================================
--- release/commons/rng/binaries/commons-rng-1.5-bin.zip.asc (added)
+++ release/commons/rng/binaries/commons-rng-1.5-bin.zip.asc Mon Oct 10
09:41:59 2022
@@ -0,0 +1,16 @@
+-----BEGIN PGP SIGNATURE-----
+
+iQIzBAABCgAdFiEEvIej/QpUSA8Lrb69IZOf8MoqZWcFAmM9SoUACgkQIZOf8Moq
+ZWdVKg/+PhdVbDT5lgSWjHRPux57TKzpXjo6OZnCnLaH0mpYNRA0h54wsJOo0vws
+HkViEuJaIJdY8t2aRVahsFUd1G2IsAg5LWD49+DNLeEoudhaZ72f9G+RvERKTeVX
+W4R7CXVIkEbCvBZWbqMDoGwHEoefGxc4bW4Z119U8hnlHwerdKRAetWufwB3x1Ln
+Ylz5Mb1PEhlQsi/OiTTiRP5SV0qEISvfXpn4bqPdr03gvRgZWo15CGLQbAClSYFR
+l8bxe5tYZsesjDIYQrCFfUd2XfZH7dGCvHcewvs7Ue3E7hLmxBYaOzG8U+hf+NNz
+iEV2h+mAHQMS3t68AtoQzIKUJR8YiE61aECJdva4B8TMQdmXRrF/OyHghoFRPbLO
+9YHMP8FSu8iUK/IRZWfXYLpW4XVkEhj9bHT8EjBBixlArV/iM4e3cedy9uecGHOe
+n4hB1QxFcC5hCabLdXcsUwTCrkmhwpI1dXJvCLN1yE7nM4nVQgR/QLnL2Y171Y8l
+HtRkzVNkN0iVMu0YdAbDLKKa8EMn2dJBCHw5MlEVk4iOEMTti1fwGkQgcmruUAgw
+miQo4+8cpmB7LtLqolZHqtBLQdJJHFnvrgByLN6gRH5vVxj1F3NsaAa93yTqq9kC
+wLTU7t4aFvyVxi9syLsVcD1VisN8NGXd0WIVLZl2ZrDrDIcJdB0=
+=Q4MQ
+-----END PGP SIGNATURE-----
Added: release/commons/rng/binaries/commons-rng-1.5-bin.zip.sha512
==============================================================================
--- release/commons/rng/binaries/commons-rng-1.5-bin.zip.sha512 (added)
+++ release/commons/rng/binaries/commons-rng-1.5-bin.zip.sha512 Mon Oct 10
09:41:59 2022
@@ -0,0 +1 @@
+ad01629da0ef089641c4a7a8fed8e2dd9f1ed0fec3e9cc6fd19df22e0516bc8c1a4699a8d2104b5878a13ad9fbec724b85ca0a71c1e3027673cbcab8a5911b30
Added: release/commons/rng/source/commons-rng-1.5-src.tar.gz
==============================================================================
Binary file - no diff available.
Propchange: release/commons/rng/source/commons-rng-1.5-src.tar.gz
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: release/commons/rng/source/commons-rng-1.5-src.tar.gz.asc
==============================================================================
--- release/commons/rng/source/commons-rng-1.5-src.tar.gz.asc (added)
+++ release/commons/rng/source/commons-rng-1.5-src.tar.gz.asc Mon Oct 10
09:41:59 2022
@@ -0,0 +1,16 @@
+-----BEGIN PGP SIGNATURE-----
+
+iQIzBAABCgAdFiEEvIej/QpUSA8Lrb69IZOf8MoqZWcFAmM9SoYACgkQIZOf8Moq
+ZWe52g/9HlIDXGJ973WfSvI06XzIQDEYyz+zCWxDT+tZ+fNxifZiWsYIzIHuHGQ0
+JRQuNv+qN5EhIOl/wWVx3gVZ7YvrzYBIpHSbDIHGlAYNM7u13IDZW2KXjAC5xS2n
+6dXUaE5sZMYwXCnHVfomIXlDir12QlY9FxCVw3apn967y+tbeYowx7jI6FsL9JCI
+QhnBtFKXcwFkAyR8Y41wvC85Kglyxe/o6PzWIL7O1es8wqQ+iDwg7fy74Ndnu4TV
+pJskXMvHTUuy6YqBjYtoj7oEPGJhDNGOkWwlM1JK6odUN5uiSsvdEziRuZa/4egr
+ohKgCJjhIJlmVCHkbmPexL+FHzYgv99zMj3HOcJHAVUaYs+tl4t8cH36wYPpIDPp
+4NCeedzQP9CI3WKv1G9qIznlaWCwFT5peiJsJzNNFelor4NWrSNKHZyAGN8sHxG6
+JjMNflwlXiCjVWU6LZdpgtZ8YYAqeZ8sjesY4zNInfcxYEIbIhlN5K19j2IChK+o
+AKiMOOnERhArUM0pnXcaBBVbMifz2DL9O8EShZzhKFvFi9PXsvsgsLEIz/V6TCPE
+tuODquVHbxM4hv3AaZPvGlRKowpqlN69snKtU/l8kZnIh9jhPk2X2hlMJn+SVCEy
+xLa9Okq6jUJ7RBGQGtG8hU9fG6K/D7IT5x7NcpPMRHuS7xy9oU0=
+=xobJ
+-----END PGP SIGNATURE-----
Added: release/commons/rng/source/commons-rng-1.5-src.tar.gz.sha512
==============================================================================
--- release/commons/rng/source/commons-rng-1.5-src.tar.gz.sha512 (added)
+++ release/commons/rng/source/commons-rng-1.5-src.tar.gz.sha512 Mon Oct 10
09:41:59 2022
@@ -0,0 +1 @@
+7fdfcd9ee43ac51f73eb6781d8fae7f313bf20658af84383ff791779def56c690458b99f2e996ce7fec8588db3218f23eea6dc6c2ff7d692f4209b78eb4b4dd8
Added: release/commons/rng/source/commons-rng-1.5-src.zip
==============================================================================
Binary file - no diff available.
Propchange: release/commons/rng/source/commons-rng-1.5-src.zip
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: release/commons/rng/source/commons-rng-1.5-src.zip.asc
==============================================================================
--- release/commons/rng/source/commons-rng-1.5-src.zip.asc (added)
+++ release/commons/rng/source/commons-rng-1.5-src.zip.asc Mon Oct 10 09:41:59
2022
@@ -0,0 +1,16 @@
+-----BEGIN PGP SIGNATURE-----
+
+iQIzBAABCgAdFiEEvIej/QpUSA8Lrb69IZOf8MoqZWcFAmM9SoYACgkQIZOf8Moq
+ZWfuPA//eB/TYAhX0FKzVAoJqS1m7uUOsfrtf/CUtvkQQ0i1Q5iBmeWZa0krqbOY
+qaAkfOKVbO1goNhimXSVqDIn3wFJJBx2A50SHCea7HIfChVXm97nSFmph0HJMzPa
+UJBGxeEHIyhiFqkNnGmYnZCduWWBCWjNYWU8ScZM2KSvhnFZc45Kx3s/4AHNG61M
+T7Rd0qJ/eh2NIXoRUV7r4YlHTPFgtPW+9/I7sBeqct/wuRefGlOLSDQz8aUdlVTT
+JCIeZba3gWnRl4PjAiFBMkCRcN/ILE9ISQe332vc9XEGU4bJ1HZQkLx6grBQKQjW
+xzjoaLybfcaD9vMB8L8gx0rUcCGQa3q2TfPl+qEnR2QO8wxwkCmNZrBCicYxWEAg
+g85vvW4CNp8m0RZAjkn8AJ8I/fTmFV5rSVsWYeCOvkq1KbgLDiKHg5KmcGBGS2GP
+LXWw+ok9dIZQQtns3Tp6R+Di2nn7YUG1KyVlOk34/dWEpjDRgOMR3Vwc50dbYuqi
+IhjVjoHhDoWg9U2WjttE6XFO6b+In5BnE+DeUndUxrQvi2I5sE22wCkHy/SF3aT0
+G9QisL+XADbjJ7DDzyZtmEeaZgltTbxWxaPjAzIFhk7vIasszxgoj+6zOsvjxFcI
+uVCuPdIsaWXu561A90ozhWfDZM2G2h5B5ZTYgfJ2vv3GO5ZfnBs=
+=Zth2
+-----END PGP SIGNATURE-----
Added: release/commons/rng/source/commons-rng-1.5-src.zip.sha512
==============================================================================
--- release/commons/rng/source/commons-rng-1.5-src.zip.sha512 (added)
+++ release/commons/rng/source/commons-rng-1.5-src.zip.sha512 Mon Oct 10
09:41:59 2022
@@ -0,0 +1 @@
+e1624601d449eecca660839b592c4deb7386ef77a09d613002e8220149f244cbb5bc70c08100fe27eb0d448efea7aef8ac1ebe26f416d846ba3bccd4f43d82e5
