From 17145e85e283d37d97c3f330a8f52380555bca52 Mon Sep 17 00:00:00 2001
From: Alex Herbert <aherbert@apache.org>
Date: Mon, 8 Jul 2024 15:17:20 +0100
Subject: [PATCH] Javadoc protected/public constructors and methods

Added to avoid warnings when building on Java 21 (which fail the build).

This requires adding implicit public constructors.
---
 .../java/org/apache/commons/rng/core/BaseProvider.java |  3 +++
 .../commons/rng/examples/quadrature/ComputePi.java     |  4 ++++
 .../distribution/AhrensDieterExponentialSampler.java   |  2 ++
 .../distribution/BoxMullerGaussianSampler.java         |  2 ++
 .../distribution/BoxMullerLogNormalSampler.java        |  2 ++
 .../BoxMullerNormalizedGaussianSampler.java            |  2 ++
 .../distribution/ContinuousUniformSampler.java         |  2 ++
 .../rng/sampling/distribution/GaussianSampler.java     |  2 ++
 .../InverseTransformContinuousSampler.java             |  2 ++
 .../distribution/InverseTransformDiscreteSampler.java  |  2 ++
 .../distribution/InverseTransformParetoSampler.java    |  2 ++
 .../sampling/distribution/LargeMeanPoissonSampler.java |  2 ++
 .../rng/sampling/distribution/LogNormalSampler.java    |  2 ++
 .../MarsagliaNormalizedGaussianSampler.java            |  2 ++
 .../rng/sampling/distribution/PoissonSamplerCache.java |  2 ++
 .../commons/rng/sampling/distribution/SamplerBase.java | 10 ++++++++++
 .../sampling/distribution/SmallMeanPoissonSampler.java |  2 ++
 .../ZigguratNormalizedGaussianSampler.java             |  2 ++
 .../commons/rng/sampling/shape/UnitBallSampler.java    |  5 +++++
 .../org/apache/commons/rng/simple/JDKRandomBridge.java |  4 ++++
 .../rng/simple/internal/ByteArray2IntArray.java        |  3 +++
 .../rng/simple/internal/ByteArray2LongArray.java       |  3 +++
 .../apache/commons/rng/simple/internal/Int2Long.java   |  3 +++
 .../commons/rng/simple/internal/IntArray2Int.java      |  3 +++
 .../rng/simple/internal/IntArray2LongArray.java        |  3 +++
 .../apache/commons/rng/simple/internal/Long2Int.java   |  3 +++
 .../commons/rng/simple/internal/Long2IntArray.java     |  2 ++
 .../commons/rng/simple/internal/Long2LongArray.java    |  2 ++
 .../rng/simple/internal/LongArray2IntArray.java        |  3 +++
 .../commons/rng/simple/internal/LongArray2Long.java    |  3 +++
 .../commons/rng/simple/internal/NoOpConverter.java     |  3 +++
 .../rng/simple/internal/SeedConverterComposer.java     |  2 ++
 32 files changed, 89 insertions(+)

diff --git a/commons-rng-core/src/main/java/org/apache/commons/rng/core/BaseProvider.java b/commons-rng-core/src/main/java/org/apache/commons/rng/core/BaseProvider.java
index 5bf39309c..30f9cbf13 100644
--- a/commons-rng-core/src/main/java/org/apache/commons/rng/core/BaseProvider.java
+++ b/commons-rng-core/src/main/java/org/apache/commons/rng/core/BaseProvider.java
@@ -37,6 +37,9 @@ public abstract class BaseProvider
     /** The fractional part of the golden ratio, phi, scaled to 32-bits and rounded to odd. */
     private static final int GOLDEN_RATIO_32 = 0x9e3779b9;
 
+    /** Create an instance. */
+    public BaseProvider() {}
+
     /** {@inheritDoc} */
     @Override
     public RandomProviderState saveState() {
diff --git a/commons-rng-examples/examples-quadrature/src/main/java/org/apache/commons/rng/examples/quadrature/ComputePi.java b/commons-rng-examples/examples-quadrature/src/main/java/org/apache/commons/rng/examples/quadrature/ComputePi.java
index 829895f2b..bb0d6e9de 100644
--- a/commons-rng-examples/examples-quadrature/src/main/java/org/apache/commons/rng/examples/quadrature/ComputePi.java
+++ b/commons-rng-examples/examples-quadrature/src/main/java/org/apache/commons/rng/examples/quadrature/ComputePi.java
@@ -40,6 +40,8 @@ public class ComputePi extends MonteCarloIntegration {
     private static final int DIMENSION = 2;
 
     /**
+     * Create an instance.
+     *
      * @param rng RNG.
      */
     public ComputePi(UniformRandomProvider rng) {
@@ -78,6 +80,8 @@ public static void main(String[] args) {
     }
 
     /**
+     * Compute the value of pi.
+     *
      * @param numPoints Number of random points to generate.
      * @return the approximate value of pi.
      */
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/AhrensDieterExponentialSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/AhrensDieterExponentialSampler.java
index 86fac42ae..203ebbb46 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/AhrensDieterExponentialSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/AhrensDieterExponentialSampler.java
@@ -73,6 +73,8 @@ public class AhrensDieterExponentialSampler
     }
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      * @param mean Mean of this distribution.
      * @throws IllegalArgumentException if {@code mean <= 0}
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerGaussianSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerGaussianSampler.java
index 008e4356a..fb6ab72a1 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerGaussianSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerGaussianSampler.java
@@ -48,6 +48,8 @@ public class BoxMullerGaussianSampler
     private final UniformRandomProvider rng;
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      * @param mean Mean of the Gaussian distribution.
      * @param standardDeviation Standard deviation of the Gaussian distribution.
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerLogNormalSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerLogNormalSampler.java
index 8628434b3..049bba1c5 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerLogNormalSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerLogNormalSampler.java
@@ -42,6 +42,8 @@ public class BoxMullerLogNormalSampler
     private final ContinuousSampler sampler;
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      * @param mu Mean of the natural logarithm of the distribution values.
      * @param sigma Standard deviation of the natural logarithm of the distribution values.
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerNormalizedGaussianSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerNormalizedGaussianSampler.java
index 6553c7906..ced4024de 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerNormalizedGaussianSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/BoxMullerNormalizedGaussianSampler.java
@@ -40,6 +40,8 @@ public class BoxMullerNormalizedGaussianSampler
     private final UniformRandomProvider rng;
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      */
     public BoxMullerNormalizedGaussianSampler(UniformRandomProvider rng) {
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/ContinuousUniformSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/ContinuousUniformSampler.java
index ac0c84501..53ccd24e3 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/ContinuousUniformSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/ContinuousUniformSampler.java
@@ -72,6 +72,8 @@ public SharedStateContinuousSampler withUniformRandomProvider(UniformRandomProvi
     }
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      * @param lo Lower bound.
      * @param hi Higher bound.
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/GaussianSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/GaussianSampler.java
index 7a080e1f1..3db9a8759 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/GaussianSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/GaussianSampler.java
@@ -41,6 +41,8 @@ public class GaussianSampler implements SharedStateContinuousSampler {
     private final NormalizedGaussianSampler normalized;
 
     /**
+     * Create an instance.
+     *
      * @param normalized Generator of N(0,1) Gaussian distributed random numbers.
      * @param mean Mean of the Gaussian distribution.
      * @param standardDeviation Standard deviation of the Gaussian distribution.
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformContinuousSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformContinuousSampler.java
index e274123b8..db68e87aa 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformContinuousSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformContinuousSampler.java
@@ -64,6 +64,8 @@ public class InverseTransformContinuousSampler
     private final UniformRandomProvider rng;
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      * @param function Inverse cumulative probability function.
      */
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformDiscreteSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformDiscreteSampler.java
index bab46280e..414618325 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformDiscreteSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformDiscreteSampler.java
@@ -64,6 +64,8 @@ public class InverseTransformDiscreteSampler
     private final UniformRandomProvider rng;
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      * @param function Inverse cumulative probability function.
      */
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformParetoSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformParetoSampler.java
index 2470033dd..08cfaedbe 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformParetoSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/InverseTransformParetoSampler.java
@@ -39,6 +39,8 @@ public class InverseTransformParetoSampler
     private final LongToDoubleFunction nextDouble;
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      * @param scale Scale of the distribution.
      * @param shape Shape of the distribution.
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/LargeMeanPoissonSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/LargeMeanPoissonSampler.java
index 245ad8896..41e1b53c2 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/LargeMeanPoissonSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/LargeMeanPoissonSampler.java
@@ -119,6 +119,8 @@ public int sample() {
 
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      * @param mean Mean.
      * @throws IllegalArgumentException if {@code mean < 1} or
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/LogNormalSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/LogNormalSampler.java
index b56b6ab6d..52f027083 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/LogNormalSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/LogNormalSampler.java
@@ -32,6 +32,8 @@ public class LogNormalSampler implements SharedStateContinuousSampler {
     private final NormalizedGaussianSampler gaussian;
 
     /**
+     * Create an instance.
+     *
      * @param gaussian N(0,1) generator.
      * @param mu Mean of the natural logarithm of the distribution values.
      * @param sigma Standard deviation of the natural logarithm of the distribution values.
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/MarsagliaNormalizedGaussianSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/MarsagliaNormalizedGaussianSampler.java
index bfd96d052..2e2d7e328 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/MarsagliaNormalizedGaussianSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/MarsagliaNormalizedGaussianSampler.java
@@ -37,6 +37,8 @@ public class MarsagliaNormalizedGaussianSampler
     private final UniformRandomProvider rng;
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      */
     public MarsagliaNormalizedGaussianSampler(UniformRandomProvider rng) {
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/PoissonSamplerCache.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/PoissonSamplerCache.java
index 8c2ae232e..3b229b2df 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/PoissonSamplerCache.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/PoissonSamplerCache.java
@@ -79,6 +79,8 @@ public class PoissonSamplerCache {
     private final LargeMeanPoissonSamplerState[] values;
 
     /**
+     * Create an instance.
+     *
      * @param minMean The minimum mean covered by the cache.
      * @param maxMean The maximum mean covered by the cache.
      * @throws IllegalArgumentException if {@code maxMean < minMean}
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/SamplerBase.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/SamplerBase.java
index 2b1e0a167..9fa034675 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/SamplerBase.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/SamplerBase.java
@@ -31,6 +31,8 @@ public class SamplerBase {
     private final UniformRandomProvider rng;
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      */
     protected SamplerBase(UniformRandomProvider rng) {
@@ -38,6 +40,8 @@ protected SamplerBase(UniformRandomProvider rng) {
     }
 
     /**
+     * Return the next {@code double} value.
+     *
      * @return a random value from a uniform distribution in the
      * interval {@code [0, 1)}.
      */
@@ -46,6 +50,8 @@ protected double nextDouble() {
     }
 
     /**
+     * Return the next {@code int} value.
+     *
      * @return a random {@code int} value.
      */
     protected int nextInt() {
@@ -53,6 +59,8 @@ protected int nextInt() {
     }
 
     /**
+     * Return the next {@code int} value.
+     *
      * @param max Upper bound (excluded).
      * @return a random {@code int} value in the interval {@code [0, max)}.
      */
@@ -61,6 +69,8 @@ protected int nextInt(int max) {
     }
 
     /**
+     * Return the next {@code long} value.
+     *
      * @return a random {@code long} value.
      */
     protected long nextLong() {
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/SmallMeanPoissonSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/SmallMeanPoissonSampler.java
index 7fb74e883..9cd617f3e 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/SmallMeanPoissonSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/SmallMeanPoissonSampler.java
@@ -54,6 +54,8 @@ public class SmallMeanPoissonSampler
     private final UniformRandomProvider rng;
 
     /**
+     * Create an instance.
+     *
      * @param rng  Generator of uniformly distributed random numbers.
      * @param mean Mean.
      * @throws IllegalArgumentException if {@code mean <= 0} or {@code Math.exp(-mean) == 0}
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/ZigguratNormalizedGaussianSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/ZigguratNormalizedGaussianSampler.java
index a78fccc4a..5002d2617 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/ZigguratNormalizedGaussianSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/distribution/ZigguratNormalizedGaussianSampler.java
@@ -95,6 +95,8 @@ public class ZigguratNormalizedGaussianSampler
     }
 
     /**
+     * Create an instance.
+     *
      * @param rng Generator of uniformly distributed random numbers.
      */
     public ZigguratNormalizedGaussianSampler(UniformRandomProvider rng) {
diff --git a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/shape/UnitBallSampler.java b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/shape/UnitBallSampler.java
index aaee46c63..795e3e475 100644
--- a/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/shape/UnitBallSampler.java
+++ b/commons-rng-sampling/src/main/java/org/apache/commons/rng/sampling/shape/UnitBallSampler.java
@@ -201,6 +201,11 @@ public UnitBallSampler withUniformRandomProvider(UniformRandomProvider rng) {
         }
     }
 
+    /**
+     * Create an instance.
+     */
+    public UnitBallSampler() {}
+
     /**
      * @return a random Cartesian coordinate within the unit n-ball.
      */
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/JDKRandomBridge.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/JDKRandomBridge.java
index d01103150..0db7bf479 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/JDKRandomBridge.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/JDKRandomBridge.java
@@ -95,6 +95,8 @@ protected int next(int n) {
     }
 
     /**
+     * Serialization method.
+     *
      * @param output Output stream.
      * @throws IOException if an error occurs.
      */
@@ -115,6 +117,8 @@ private void writeObject(ObjectOutputStream output)
     }
 
     /**
+     * Deserialization method.
+     *
      * @param input Input stream.
      * @throws IOException if an error occurs.
      * @throws ClassNotFoundException if an error occurs.
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/ByteArray2IntArray.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/ByteArray2IntArray.java
index ad04e4170..18af6024b 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/ByteArray2IntArray.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/ByteArray2IntArray.java
@@ -22,6 +22,9 @@
  * @since 1.0
  */
 public class ByteArray2IntArray implements SeedConverter<byte[], int[]> {
+    /** Create an instance. */
+    public ByteArray2IntArray() {}
+
     /** {@inheritDoc} */
     @Override
     public int[] convert(byte[] seed) {
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/ByteArray2LongArray.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/ByteArray2LongArray.java
index 9be36f2ba..afddf6aa7 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/ByteArray2LongArray.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/ByteArray2LongArray.java
@@ -22,6 +22,9 @@
  * @since 1.0
  */
 public class ByteArray2LongArray implements SeedConverter<byte[], long[]> {
+    /** Create an instance. */
+    public ByteArray2LongArray() {}
+
     /** {@inheritDoc} */
     @Override
     public long[] convert(byte[] seed) {
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Int2Long.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Int2Long.java
index 9f23a640d..cb7e9594b 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Int2Long.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Int2Long.java
@@ -22,6 +22,9 @@
  * @since 1.0
  */
 public class Int2Long implements SeedConverter<Integer, Long> {
+    /** Create an instance. */
+    public Int2Long() {}
+
     /** {@inheritDoc} */
     @Override
     public Long convert(Integer seed) {
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/IntArray2Int.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/IntArray2Int.java
index af742d045..b279aa6cc 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/IntArray2Int.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/IntArray2Int.java
@@ -22,6 +22,9 @@
  * @since 1.0
  */
 public class IntArray2Int implements SeedConverter<int[], Integer> {
+    /** Create an instance. */
+    public IntArray2Int() {}
+
     /** {@inheritDoc} */
     @Override
     public Integer convert(int[] seed) {
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/IntArray2LongArray.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/IntArray2LongArray.java
index 203777a44..b647be6b7 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/IntArray2LongArray.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/IntArray2LongArray.java
@@ -26,6 +26,9 @@
  * @since 1.0
  */
 public class IntArray2LongArray implements SeedConverter<int[], long[]> {
+    /** Create an instance. */
+    public IntArray2LongArray() {}
+
     /** {@inheritDoc} */
     @Override
     public long[] convert(int[] seed) {
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2Int.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2Int.java
index a7f39cd66..76b3366a6 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2Int.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2Int.java
@@ -24,6 +24,9 @@
  * @since 1.0
  */
 public class Long2Int implements SeedConverter<Long, Integer> {
+    /** Create an instance. */
+    public Long2Int() {}
+
     /** {@inheritDoc} */
     @SuppressWarnings("deprecation")
     @Override
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2IntArray.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2IntArray.java
index b4c059449..6f09b2349 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2IntArray.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2IntArray.java
@@ -29,6 +29,8 @@ public class Long2IntArray implements Seed2ArrayConverter<Long, int[]> {
     private final int size;
 
     /**
+     * Create an instance.
+     *
      * @param size Size of the output array.
      */
     public Long2IntArray(int size) {
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2LongArray.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2LongArray.java
index 02264c2d9..eb873cd17 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2LongArray.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/Long2LongArray.java
@@ -29,6 +29,8 @@ public class Long2LongArray implements Seed2ArrayConverter<Long, long[]> {
     private final int size;
 
     /**
+     * Create an instance.
+     *
      * @param size Size of the output array.
      */
     public Long2LongArray(int size) {
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/LongArray2IntArray.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/LongArray2IntArray.java
index 6cff84c95..c142cc5c1 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/LongArray2IntArray.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/LongArray2IntArray.java
@@ -25,6 +25,9 @@
  * @since 1.0
  */
 public class LongArray2IntArray implements SeedConverter<long[], int[]> {
+    /** Create an instance. */
+    public LongArray2IntArray() {}
+
     /** {@inheritDoc} */
     @Override
     public int[] convert(long[] seed) {
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/LongArray2Long.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/LongArray2Long.java
index 39257a36c..65f41b593 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/LongArray2Long.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/LongArray2Long.java
@@ -22,6 +22,9 @@
  * @since 1.0
  */
 public class LongArray2Long implements SeedConverter<long[], Long> {
+    /** Create an instance. */
+    public LongArray2Long() {}
+
     /** {@inheritDoc} */
     @Override
     public Long convert(long[] seed) {
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/NoOpConverter.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/NoOpConverter.java
index b340357a5..e6c1dfb17 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/NoOpConverter.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/NoOpConverter.java
@@ -26,6 +26,9 @@
  * @since 1.0
  */
 public class NoOpConverter<SEED> implements SeedConverter<SEED, SEED> {
+    /** Create an instance. */
+    public NoOpConverter() {}
+
     /** {@inheritDoc} */
     @Override
     public SEED convert(SEED seed) {
diff --git a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/SeedConverterComposer.java b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/SeedConverterComposer.java
index 4125a28b3..15c4e1800 100644
--- a/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/SeedConverterComposer.java
+++ b/commons-rng-simple/src/main/java/org/apache/commons/rng/simple/internal/SeedConverterComposer.java
@@ -32,6 +32,8 @@ public class SeedConverterComposer<IN, TRANS, OUT> implements SeedConverter<IN,
     private final SeedConverter<TRANS, OUT> second;
 
     /**
+     * Create an instance.
+     *
      * @param first First conversion.
      * @param second second conversion.
      */