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