minor refactor: remove javadoc warnings

Author: paulk-asert

build-logic/src/main/groovy/org.apache.groovy-documented.gradle

@@ -56,6 +56,13 @@ tasks.withType(Javadoc).configureEach {
     options {
         addBooleanOption('html5', true)
         addStringOption('Xdoclint:none', '-quiet')
+        // JUnit 5 (and other libs) ship as named modules; this project's
+        // sources are in the unnamed module. JDK 21+ javadoc warns by default
+        // when --link targets a named-module API from the unnamed module.
+        // Downgrade to info so it doesn't pollute the build output.
+        if (JavaVersion.current() >= JavaVersion.VERSION_21) {
+            addStringOption('-link-modularity-mismatch', 'info')
+        }
         addStringOption('tag', 'apiNote:a:"API Note:"')
         addStringOption('tag', 'implSpec:a:"Implementation Requirements:"')
         addStringOption('tag', 'implNote:a:"Implementation Note:"')

src/main/java/org/codehaus/groovy/runtime/typehandling/LongMath.java

@@ -129,7 +129,7 @@ public Number rightShiftUnsignedImpl(Number left, Number right) {
     /**
      * Bitwise AND operation for long values.
      * <p>
-     * Performs a bitwise AND (&) between two numbers converted to long values.
+     * Performs a bitwise AND (&amp;) between two numbers converted to long values.
      *
      * @param left the first operand
      * @param right the second operand

src/main/java/org/codehaus/groovy/runtime/typehandling/NumberMathModificationInfo.java

@@ -257,27 +257,27 @@ private void doCheckNumberOps(Class klazz, Consumer<Class> byteConsumer, Consume
     public boolean double_or;
 
     /**
-     * Flags indicating whether the bitwise AND (&) operation has been modified for Byte type.
+     * Flags indicating whether the bitwise AND (&amp;) operation has been modified for Byte type.
      */
     public boolean byte_and;
     /**
-     * Flags indicating whether the bitwise AND (&) operation has been modified for Short type.
+     * Flags indicating whether the bitwise AND (&amp;) operation has been modified for Short type.
      */
     public boolean short_and;
     /**
-     * Flags indicating whether the bitwise AND (&) operation has been modified for Integer type.
+     * Flags indicating whether the bitwise AND (&amp;) operation has been modified for Integer type.
      */
     public boolean int_and;
     /**
-     * Flags indicating whether the bitwise AND (&) operation has been modified for Long type.
+     * Flags indicating whether the bitwise AND (&amp;) operation has been modified for Long type.
      */
     public boolean long_and;
     /**
-     * Flags indicating whether the bitwise AND (&) operation has been modified for Float type.
+     * Flags indicating whether the bitwise AND (&amp;) operation has been modified for Float type.
      */
     public boolean float_and;
     /**
-     * Flags indicating whether the bitwise AND (&) operation has been modified for Double type.
+     * Flags indicating whether the bitwise AND (&amp;) operation has been modified for Double type.
      */
     public boolean double_and;
 
@@ -382,27 +382,27 @@ private void doCheckNumberOps(Class klazz, Consumer<Class> byteConsumer, Consume
     public boolean double_remainder;
 
     /**
-     * Flags indicating whether the left shift (<<) operation has been modified for Byte type.
+     * Flags indicating whether the left shift (&lt;&lt;) operation has been modified for Byte type.
      */
     public boolean byte_leftShift;
     /**
-     * Flags indicating whether the left shift (<<) operation has been modified for Short type.
+     * Flags indicating whether the left shift (&lt;&lt;) operation has been modified for Short type.
      */
     public boolean short_leftShift;
     /**
-     * Flags indicating whether the left shift (<<) operation has been modified for Integer type.
+     * Flags indicating whether the left shift (&lt;&lt;) operation has been modified for Integer type.
      */
     public boolean int_leftShift;
     /**
-     * Flags indicating whether the left shift (<<) operation has been modified for Long type.
+     * Flags indicating whether the left shift (&lt;&lt;) operation has been modified for Long type.
      */
     public boolean long_leftShift;
     /**
-     * Flags indicating whether the left shift (<<) operation has been modified for Float type.
+     * Flags indicating whether the left shift (&lt;&lt;) operation has been modified for Float type.
      */
     public boolean float_leftShift;
     /**
-     * Flags indicating whether the left shift (<<) operation has been modified for Double type.
+     * Flags indicating whether the left shift (&lt;&lt;) operation has been modified for Double type.
      */
     public boolean double_leftShift;