Minor comment updates, add release notes

Author: cowtowncoder

release-notes/CREDITS

@@ -151,3 +151,7 @@ Daniel Albuquerque (worldtiki@github)
 Alexander Ilinykh (divinenickname@github)
   * Contributed improvements to README.md, pom.xml (OSGi inclusion)
    [5.1.1]
+
+Chad Parry (chadparry@github)
+  * Contributed #124: TimeBasedEpochGenerator should prevent overflow
+   [5.3.0]

release-notes/VERSION

@@ -6,6 +6,8 @@ Releases
 
 5.2.0 (not yet released)
 
+#124: TimeBasedEpochGenerator should prevent overflow
+ (Chad P)
 - Update to `oss-parent` v69
 
 5.1.1 (26-Sep-2025)

src/main/java/com/fasterxml/uuid/impl/TimeBasedEpochGenerator.java

@@ -34,7 +34,9 @@ public class TimeBasedEpochGenerator extends NoArgGenerator
      */
 
     /**
-     * Random number generator that fills a byte array with entropy
+     * Source for random numbers used to fill a byte array with entropy.
+     *
+     * @since 5.3 (replaced earlier {@code java.util.Random _random})
      */
     protected final Consumer<byte[]> _randomNextBytes;
 
@@ -77,7 +79,16 @@ public TimeBasedEpochGenerator(Random rnd, UUIDClock clock)
         this((rnd == null ? LazyRandom.sharedSecureRandom() : rnd)::nextBytes, clock);
     }
 
-    TimeBasedEpochGenerator(Consumer<byte[]> randomNextBytes, UUIDClock clock)
+    /**
+     * 
+     * @param randomNextBytes Source for random numbers to use for generating UUIDs.
+     *  Note that it is strongly recommend to use a <b>good</b> (pseudo) random number source;
+     *  for example, JDK's {@code SecureRandom::nextBytes}.
+     * @param clock clock Object used for accessing current time to use for generation
+     *
+     * @since 5.3
+     */
+    protected TimeBasedEpochGenerator(Consumer<byte[]> randomNextBytes, UUIDClock clock)
     {
         _randomNextBytes = randomNextBytes;
         _clock = clock;

src/test/java/com/fasterxml/uuid/impl/TimeBasedEpochGeneratorTest.java

@@ -1,15 +1,18 @@
 package com.fasterxml.uuid.impl;
 
-import com.fasterxml.uuid.UUIDClock;
-import junit.framework.TestCase;
-
 import java.math.BigInteger;
 import java.util.Arrays;
 import java.util.UUID;
 import java.util.function.Consumer;
 
-public class TimeBasedEpochGeneratorTest extends TestCase {
+import com.fasterxml.uuid.UUIDClock;
+import junit.framework.TestCase;
 
+/**
+ * @since 5.3
+ */
+public class TimeBasedEpochGeneratorTest extends TestCase
+{
     public void testFormat() {
         BigInteger minEntropy = BigInteger.ZERO;
         long minTimestamp = 0;