Add missing javadoc

Author: daniellansun

src/main/groovy/org/codehaus/groovy/classgen/genArrayAccess.groovy

@@ -36,6 +36,11 @@ public class ArrayOperations {
 }
 """
 
+/**
+ * Generates the inner meta-method classes for each primitive array type.
+ *
+ * @return the Java source for the generated inner classes
+ */
 def genInners () {
     def res = ''
 

src/main/groovy/org/codehaus/groovy/classgen/genArrayUtil.groovy

@@ -26,13 +26,24 @@ public class ArrayUtil {
 
 """
 
+/**
+ * Generates all supported {@code createArray} overloads.
+ *
+ * @return the Java source for the overload set
+ */
 def genMethods () {
     def res = ''
     for (i in 1..250)
       res += '\n\n' + genMethod (i)
     res
 }
 
+/**
+ * Generates a single {@code createArray} overload for the supplied arity.
+ *
+ * @param paramNum the number of array elements accepted by the overload
+ * @return the Java source for the generated overload
+ */
 def genMethod (int paramNum) {
     def res = 'public static Object [] createArray ('
     for (k in 0..<paramNum) {

src/main/groovy/org/codehaus/groovy/classgen/genDgmMath.groovy

@@ -18,8 +18,18 @@
  */
 package org.codehaus.groovy.classgen
 
+/**
+ * Emits numeric call-site specializations for default Groovy method math operations.
+ */
 def types = ['Integer', 'Long', 'Float', 'Double']
 
+/**
+ * Returns the {@code NumberMath} implementation name for the supplied boxed operand types.
+ *
+ * @param a the left operand type name
+ * @param b the right operand type name
+ * @return the helper class name that should implement the operation
+ */
 def getMath (a,b) {
     if (a == 'Double' || b == 'Double' || a == 'Float' || b == 'Float')
       return 'FloatingPointMath'

src/main/groovy/org/codehaus/groovy/classgen/genMathModification.groovy

@@ -18,6 +18,9 @@
  */
 package org.codehaus.groovy.classgen
 
+/**
+ * Emits the numeric helper source used by {@code NumberMathModificationInfo}.
+ */
 def ops = [
         'plus',
         'minus',
@@ -77,14 +80,33 @@ ops.each { op ->
     }
 }
 
+/**
+ * Determines whether the supplied boxed number type is floating point.
+ *
+ * @param number the boxed number type name
+ * @return {@code true} for {@code Double} or {@code Float}
+ */
 def isFloatingPoint(number) {
     number == 'Double' || number == 'Float'
 }
 
+/**
+ * Determines whether the supplied boxed number type is {@code Long}.
+ *
+ * @param number the boxed number type name
+ * @return {@code true} when the type is {@code Long}
+ */
 def isLong(number) {
     number == 'Long'
 }
 
+/**
+ * Returns the arithmetic operator metadata for the supplied boxed operand types.
+ *
+ * @param left the left operand type name
+ * @param right the right operand type name
+ * @return a map describing the result type and supported operators
+ */
 def getMath (left, right) {
     if (isFloatingPoint(left) || isFloatingPoint(right)) {
         return [

src/main/groovy/org/codehaus/groovy/control/customizers/ASTTransformationCustomizer.groovy

@@ -87,8 +87,14 @@ import static org.codehaus.groovy.ast.tools.GeneralUtils.propX
 class ASTTransformationCustomizer extends CompilationCustomizer implements CompilationUnitAware {
 
     private boolean applied // global xforms
+    /**
+     * Compilation unit currently being customized.
+     */
     protected CompilationUnit compilationUnit
     private final AnnotationNode annotationNode
+    /**
+     * Transformation instance applied by this customizer.
+     */
             final ASTTransformation transformation
 
     /**
@@ -136,6 +142,14 @@ class ASTTransformationCustomizer extends CompilationCustomizer implements Compi
         this.annotationParameters = annotationParams
     }
 
+    /**
+     * Creates an AST transformation customizer using the specified annotation, annotation parameters,
+     * and transformation class name.
+     *
+     * @param annotationParams the annotation member values to apply
+     * @param transformationAnnotation the transformation annotation type
+     * @param astTransformationClassName the implementation class name for the transformation
+     */
     ASTTransformationCustomizer(Map annotationParams, Class<? extends Annotation> transformationAnnotation, String astTransformationClassName) {
         this(annotationParams, transformationAnnotation, transformationAnnotation.classLoader)
     }
@@ -185,10 +199,22 @@ class ASTTransformationCustomizer extends CompilationCustomizer implements Compi
         this.annotationParameters = annotationParams
     }
 
+    /**
+     * Creates an AST transformation customizer using the specified annotation and annotation parameters.
+     *
+     * @param annotationParams the annotation member values to apply
+     * @param transformationAnnotation the transformation annotation type
+     */
     ASTTransformationCustomizer(Map annotationParams, Class<? extends Annotation> transformationAnnotation) {
         this(annotationParams, transformationAnnotation, transformationAnnotation.classLoader)
     }
 
+    /**
+     * Creates an AST transformation customizer using the specified transformation and annotation parameters.
+     *
+     * @param annotationParams the annotation member values to apply
+     * @param transformation the transformation to invoke
+     */
     ASTTransformationCustomizer(Map annotationParams, ASTTransformation transformation) {
         this(transformation)
         this.annotationParameters = annotationParams
@@ -373,11 +399,23 @@ class ASTTransformationCustomizer extends CompilationCustomizer implements Compi
 
     //--------------------------------------------------------------------------
 
+    /**
+     * Records the compilation unit that will receive the configured transformation.
+     *
+     * @param compilationUnit the owning compilation unit
+     */
     @Override
     void setCompilationUnit(CompilationUnit compilationUnit) {
         this.compilationUnit = compilationUnit
     }
 
+    /**
+     * Applies the configured transformation to the supplied class or source unit.
+     *
+     * @param sourceUnit the current source unit
+     * @param context the current generator context
+     * @param classNode the class node being customized
+     */
     @Override
     void call(SourceUnit sourceUnit, GeneratorContext context, ClassNode classNode) {
         if (transformation instanceof CompilationUnitAware unitAware) {

src/main/groovy/org/codehaus/groovy/control/customizers/builder/ASTTransformationCustomizerFactory.groovy

@@ -36,16 +36,40 @@ import org.codehaus.groovy.control.customizers.ASTTransformationCustomizer
 @CompileStatic
 class ASTTransformationCustomizerFactory extends AbstractFactory {
 
+    /**
+     * Indicates that {@code ast} nodes do not accept nested builder content.
+     *
+     * @return {@code true}
+     */
     @Override
     boolean isLeaf() {
         true
     }
 
+    /**
+     * Leaves attribute handling to {@link #newInstance(FactoryBuilderSupport, Object, Object, Map)}.
+     *
+     * @param builder the active builder
+     * @param node the current node
+     * @param attributes the node attributes
+     * @return {@code false} to keep the attributes available for instance creation
+     */
     @Override
     boolean onHandleNodeAttributes(final FactoryBuilderSupport builder, final Object node, final Map attributes) {
         false
     }
 
+    /**
+     * Creates an {@link ASTTransformationCustomizer} for the supplied annotation and attributes.
+     *
+     * @param builder the active builder
+     * @param name the node name
+     * @param value the transformation annotation class
+     * @param attributes annotation member values to apply
+     * @return a configured {@link ASTTransformationCustomizer}
+     * @throws InstantiationException if the customizer cannot be instantiated
+     * @throws IllegalAccessException if the customizer cannot be accessed
+     */
     @Override
     @CompileDynamic
     Object newInstance(final FactoryBuilderSupport builder, final Object name, final Object value, final Map attributes) throws InstantiationException, IllegalAccessException {

src/main/groovy/org/codehaus/groovy/control/customizers/builder/CompilerCustomizationBuilder.groovy

@@ -31,13 +31,23 @@ import org.codehaus.groovy.control.CompilerConfiguration
 @AutoFinal @CompileStatic
 class CompilerCustomizationBuilder extends FactoryBuilderSupport {
 
+    /**
+     * Applies compilation customizers declared by the builder DSL to the supplied configuration.
+     *
+     * @param config the compiler configuration to customize
+     * @param spec the customization DSL
+     * @return the same {@link CompilerConfiguration} instance for chaining
+     */
     static CompilerConfiguration withConfig(CompilerConfiguration config, @DelegatesTo(type='org.codehaus.groovy.control.customizers.builder.CompilerCustomizationBuilder') Closure spec) {
         config.invokeMethod('addCompilationCustomizers', new CompilerCustomizationBuilder().invokeMethod('customizers', spec))
         config
     }
 
     //--------------------------------------------------------------------------
 
+    /**
+     * Creates a builder and registers the supported customization factories.
+     */
     CompilerCustomizationBuilder() {
         registerFactory('customizers', new CustomizersFactory()) // root
 
@@ -48,6 +58,13 @@ class CompilerCustomizationBuilder extends FactoryBuilderSupport {
         registerFactory('source', new SourceAwareCustomizerFactory())
     }
 
+    /**
+     * Finalizes a node and gives post-completion factories a chance to replace it.
+     *
+     * @param parent the parent builder node
+     * @param node the node being completed
+     * @return the completed node, possibly replaced by the active factory
+     */
     @Override
     protected Object postNodeCompletion(Object parent, Object node) {
         Object value = super.postNodeCompletion(parent, node)