This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-bcel.git
The following commit(s) were added to refs/heads/master by this push:
new e06ba269 Javadoc: Empty Javadoc line before the 1st tag.
e06ba269 is described below
commit e06ba26994e3d954ca67696bf4f92ea470c1e7b4
Author: Gary Gregory <[email protected]>
AuthorDate: Wed Dec 31 17:37:52 2025 -0500
Javadoc: Empty Javadoc line before the 1st tag.
---
src/main/java/org/apache/bcel/classfile/Code.java | 3 +++
src/main/java/org/apache/bcel/classfile/ConstantValue.java | 1 +
src/main/java/org/apache/bcel/classfile/DescendingVisitor.java | 1 +
src/main/java/org/apache/bcel/classfile/ElementValue.java | 1 +
src/main/java/org/apache/bcel/classfile/EmptyVisitor.java | 1 +
src/main/java/org/apache/bcel/classfile/ExceptionTable.java | 1 +
src/main/java/org/apache/bcel/classfile/FieldOrMethod.java | 1 +
src/main/java/org/apache/bcel/classfile/JavaClass.java | 2 ++
src/main/java/org/apache/bcel/classfile/Method.java | 1 +
src/main/java/org/apache/bcel/classfile/Module.java | 4 ++++
src/main/java/org/apache/bcel/classfile/ModuleExports.java | 3 +++
src/main/java/org/apache/bcel/classfile/ModuleOpens.java | 3 +++
src/main/java/org/apache/bcel/classfile/ModuleProvides.java | 2 ++
src/main/java/org/apache/bcel/classfile/ModuleRequires.java | 3 +++
src/main/java/org/apache/bcel/classfile/StackMapEntry.java | 1 +
src/main/java/org/apache/bcel/classfile/StackMapType.java | 1 +
src/main/java/org/apache/bcel/generic/Instruction.java | 1 +
src/main/java/org/apache/bcel/generic/ObjectType.java | 1 +
src/main/java/org/apache/bcel/util/BCELifier.java | 1 +
src/main/java/org/apache/bcel/util/ClassPath.java | 1 +
20 files changed, 33 insertions(+)
diff --git a/src/main/java/org/apache/bcel/classfile/Code.java
b/src/main/java/org/apache/bcel/classfile/Code.java
index 39c2afa3..67fda0db 100644
--- a/src/main/java/org/apache/bcel/classfile/Code.java
+++ b/src/main/java/org/apache/bcel/classfile/Code.java
@@ -54,6 +54,7 @@ import org.apache.commons.lang3.ArrayUtils;
* attribute_info attributes[attributes_count];
* }
* </pre>
+ *
* @see Attribute
* @see CodeException
* @see LineNumberTable
@@ -262,6 +263,7 @@ public final class Code extends Attribute {
/**
* Gets the local variable type table attribute {@link
LocalVariableTypeTable}.
+ *
* @return LocalVariableTypeTable of Code, if it has one, null otherwise.
* @since 6.10.0
*/
@@ -290,6 +292,7 @@ public final class Code extends Attribute {
/**
* Finds the attribute of {@link StackMap} instance.
+ *
* @return StackMap of Code, if it has one, else null.
* @since 6.8.0
*/
diff --git a/src/main/java/org/apache/bcel/classfile/ConstantValue.java
b/src/main/java/org/apache/bcel/classfile/ConstantValue.java
index 6925f67f..8b76b5ba 100644
--- a/src/main/java/org/apache/bcel/classfile/ConstantValue.java
+++ b/src/main/java/org/apache/bcel/classfile/ConstantValue.java
@@ -36,6 +36,7 @@ import org.apache.bcel.util.Args;
* u2 constantvalue_index;
* }
* </pre>
+ *
* @see Attribute
*/
public final class ConstantValue extends Attribute {
diff --git a/src/main/java/org/apache/bcel/classfile/DescendingVisitor.java
b/src/main/java/org/apache/bcel/classfile/DescendingVisitor.java
index cf5bff6d..770f547c 100644
--- a/src/main/java/org/apache/bcel/classfile/DescendingVisitor.java
+++ b/src/main/java/org/apache/bcel/classfile/DescendingVisitor.java
@@ -554,6 +554,7 @@ public class DescendingVisitor implements Visitor {
/**
* Visits a {@link StackMapType} object.
+ *
* @param var object to visit
* @since 6.8.0
*/
diff --git a/src/main/java/org/apache/bcel/classfile/ElementValue.java
b/src/main/java/org/apache/bcel/classfile/ElementValue.java
index f39631f3..0ae84941 100644
--- a/src/main/java/org/apache/bcel/classfile/ElementValue.java
+++ b/src/main/java/org/apache/bcel/classfile/ElementValue.java
@@ -48,6 +48,7 @@ import org.apache.bcel.Const;
* } value;
*}
*</pre>
+ *
* @since 6.0
*/
public abstract class ElementValue {
diff --git a/src/main/java/org/apache/bcel/classfile/EmptyVisitor.java
b/src/main/java/org/apache/bcel/classfile/EmptyVisitor.java
index 4e6b98af..9a4c6188 100644
--- a/src/main/java/org/apache/bcel/classfile/EmptyVisitor.java
+++ b/src/main/java/org/apache/bcel/classfile/EmptyVisitor.java
@@ -314,6 +314,7 @@ public class EmptyVisitor implements Visitor {
/**
* Visits a {@link StackMapType} object.
+ *
* @param obj object to visit
* @since 6.8.0
*/
diff --git a/src/main/java/org/apache/bcel/classfile/ExceptionTable.java
b/src/main/java/org/apache/bcel/classfile/ExceptionTable.java
index a81153af..eb7f244f 100644
--- a/src/main/java/org/apache/bcel/classfile/ExceptionTable.java
+++ b/src/main/java/org/apache/bcel/classfile/ExceptionTable.java
@@ -42,6 +42,7 @@ import org.apache.commons.lang3.ArrayUtils;
* u2 exception_index_table[number_of_exceptions];
* }
* </pre>
+ *
* @see Code
*/
public final class ExceptionTable extends Attribute {
diff --git a/src/main/java/org/apache/bcel/classfile/FieldOrMethod.java
b/src/main/java/org/apache/bcel/classfile/FieldOrMethod.java
index 56bdeb10..0366b108 100644
--- a/src/main/java/org/apache/bcel/classfile/FieldOrMethod.java
+++ b/src/main/java/org/apache/bcel/classfile/FieldOrMethod.java
@@ -168,6 +168,7 @@ public abstract class FieldOrMethod extends AccessFlags
implements Cloneable, No
/**
* Gets attribute for given tag.
+ *
* @return Attribute for given tag, null if not found.
* Refer to {@link org.apache.bcel.Const#ATTR_UNKNOWN} constants named
ATTR_* for possible values.
* @since 6.10.0
diff --git a/src/main/java/org/apache/bcel/classfile/JavaClass.java
b/src/main/java/org/apache/bcel/classfile/JavaClass.java
index a9589a38..829e6765 100644
--- a/src/main/java/org/apache/bcel/classfile/JavaClass.java
+++ b/src/main/java/org/apache/bcel/classfile/JavaClass.java
@@ -409,6 +409,7 @@ public class JavaClass extends AccessFlags implements
Cloneable, Node, Comparabl
/**
* Finds a visible field by name and type in this class and its super
classes.
+ *
* @param fieldName the field name to find
* @param fieldType the field type to find
* @return field matching given name and type, null if field is not found
or not accessible from this class.
@@ -486,6 +487,7 @@ public class JavaClass extends AccessFlags implements
Cloneable, Node, Comparabl
/**
* Gets attribute for given tag.
+ *
* @return Attribute for given tag, null if not found.
* Refer to {@link org.apache.bcel.Const#ATTR_UNKNOWN} constants named
ATTR_* for possible values.
* @since 6.10.0
diff --git a/src/main/java/org/apache/bcel/classfile/Method.java
b/src/main/java/org/apache/bcel/classfile/Method.java
index a01b0677..5dd62fff 100644
--- a/src/main/java/org/apache/bcel/classfile/Method.java
+++ b/src/main/java/org/apache/bcel/classfile/Method.java
@@ -191,6 +191,7 @@ public final class Method extends FieldOrMethod {
/**
* Gets the local variable type table attribute {@link
LocalVariableTypeTable}.
+ *
* @return LocalVariableTypeTable of code attribute if any, i.e. the call
is forwarded to the Code attribute.
* @since 6.10.0
*/
diff --git a/src/main/java/org/apache/bcel/classfile/Module.java
b/src/main/java/org/apache/bcel/classfile/Module.java
index 8850a177..3d62c187 100644
--- a/src/main/java/org/apache/bcel/classfile/Module.java
+++ b/src/main/java/org/apache/bcel/classfile/Module.java
@@ -192,6 +192,7 @@ public final class Module extends Attribute {
/**
* Gets flags for this module.
+ *
* @return module flags
* @since 6.10.0
*/
@@ -201,6 +202,7 @@ public final class Module extends Attribute {
/**
* Gets module name.
+ *
* @param cp Array of constants
* @return module name
* @since 6.10.0
@@ -235,6 +237,7 @@ public final class Module extends Attribute {
/**
* Gets the array of class names for this module's uses.
+ *
* @param constantPool Array of constants usually obtained from the
ClassFile object
* @param compactClassName false for original constant pool value, true to
replace '/' with '.'
* @return array of used class names
@@ -250,6 +253,7 @@ public final class Module extends Attribute {
/**
* Gets version for this module.
+ *
* @param cp Array of constants
* @return version from constant pool, "0" if version index is 0
* @since 6.10.0
diff --git a/src/main/java/org/apache/bcel/classfile/ModuleExports.java
b/src/main/java/org/apache/bcel/classfile/ModuleExports.java
index ee3e5c7b..2bca8228 100644
--- a/src/main/java/org/apache/bcel/classfile/ModuleExports.java
+++ b/src/main/java/org/apache/bcel/classfile/ModuleExports.java
@@ -99,6 +99,7 @@ public final class ModuleExports implements Cloneable, Node {
/**
* Gets the flags for this ModuleExports.
+ *
* @return the exportsFlags
* @since 6.10.0
*/
@@ -108,6 +109,7 @@ public final class ModuleExports implements Cloneable, Node
{
/**
* Gets the exported package name.
+ *
* @param constantPool the constant pool from the ClassFile
* @return the exported package name
* @since 6.10.0
@@ -118,6 +120,7 @@ public final class ModuleExports implements Cloneable, Node
{
/**
* Gets an array of module names for this ModuleExports.
+ *
* @param constantPool Array of constants usually obtained from the
ClassFile object
* @return array of module names following 'exports to'
* @since 6.10.0
diff --git a/src/main/java/org/apache/bcel/classfile/ModuleOpens.java
b/src/main/java/org/apache/bcel/classfile/ModuleOpens.java
index f7faa434..a7cfe802 100644
--- a/src/main/java/org/apache/bcel/classfile/ModuleOpens.java
+++ b/src/main/java/org/apache/bcel/classfile/ModuleOpens.java
@@ -99,6 +99,7 @@ public final class ModuleOpens implements Cloneable, Node {
/**
* Gets the flags for this ModuleOpens.
+ *
* @return the opensFlags
* @since 6.10.0
*/
@@ -108,6 +109,7 @@ public final class ModuleOpens implements Cloneable, Node {
/**
* Gets the opened package name.
+ *
* @param constantPool the constant pool from the ClassFile
* @return the opened package name
* @since 6.10.0
@@ -118,6 +120,7 @@ public final class ModuleOpens implements Cloneable, Node {
/**
* Gets an array of module names for this ModuleOpens.
+ *
* @param constantPool Array of constants usually obtained from the
ClassFile object
* @return array of module names following 'opens to'
* @since 6.10.0
diff --git a/src/main/java/org/apache/bcel/classfile/ModuleProvides.java
b/src/main/java/org/apache/bcel/classfile/ModuleProvides.java
index ca6be011..6b9ddb55 100644
--- a/src/main/java/org/apache/bcel/classfile/ModuleProvides.java
+++ b/src/main/java/org/apache/bcel/classfile/ModuleProvides.java
@@ -100,6 +100,7 @@ public final class ModuleProvides implements Cloneable,
Node {
/**
* Gets the array of implementation class names for this ModuleProvides.
+ *
* @param constantPool Array of constants usually obtained from the
ClassFile object
* @param compactClassName false for original constant pool value, true to
replace '/' with '.'
* @return array of implementation class names
@@ -115,6 +116,7 @@ public final class ModuleProvides implements Cloneable,
Node {
/**
* Gets the interface name for this ModuleProvides.
+ *
* @param constantPool Array of constants usually obtained from the
ClassFile object
* @return interface name
* @since 6.10.0
diff --git a/src/main/java/org/apache/bcel/classfile/ModuleRequires.java
b/src/main/java/org/apache/bcel/classfile/ModuleRequires.java
index 88794ee5..24a23514 100644
--- a/src/main/java/org/apache/bcel/classfile/ModuleRequires.java
+++ b/src/main/java/org/apache/bcel/classfile/ModuleRequires.java
@@ -87,6 +87,7 @@ public final class ModuleRequires implements Cloneable, Node {
/**
* Gets the module name from the constant pool.
+ *
* @param constantPool Array of constants usually obtained from the
ClassFile object
* @return module name
* @since 6.10.0
@@ -97,6 +98,7 @@ public final class ModuleRequires implements Cloneable, Node {
/**
* Gets the flags for this ModuleRequires.
+ *
* @return the requiresFlags
* @since 6.10.0
*/
@@ -106,6 +108,7 @@ public final class ModuleRequires implements Cloneable,
Node {
/**
* Gets the required version from the constant pool.
+ *
* @param constantPool Array of constants usually obtained from the
ClassFile object
* @return required version, "0" if version index is 0.
* @since 6.10.0
diff --git a/src/main/java/org/apache/bcel/classfile/StackMapEntry.java
b/src/main/java/org/apache/bcel/classfile/StackMapEntry.java
index 6fa7c425..32a11d4c 100644
--- a/src/main/java/org/apache/bcel/classfile/StackMapEntry.java
+++ b/src/main/java/org/apache/bcel/classfile/StackMapEntry.java
@@ -43,6 +43,7 @@ import org.apache.bcel.Const;
* full_frame;
* }
* </pre>
+ *
* @see StackMap
* @see StackMapType
*/
diff --git a/src/main/java/org/apache/bcel/classfile/StackMapType.java
b/src/main/java/org/apache/bcel/classfile/StackMapType.java
index e4ebff49..6381af15 100644
--- a/src/main/java/org/apache/bcel/classfile/StackMapType.java
+++ b/src/main/java/org/apache/bcel/classfile/StackMapType.java
@@ -109,6 +109,7 @@ public final class StackMapType implements Node, Cloneable {
/**
* Gets the class name of this StackMapType from the constant pool at
index position.
+ *
* @return the fully qualified name of the class for this StackMapType.
* @since 6.8.0
*/
diff --git a/src/main/java/org/apache/bcel/generic/Instruction.java
b/src/main/java/org/apache/bcel/generic/Instruction.java
index ca989787..d3f47aa1 100644
--- a/src/main/java/org/apache/bcel/generic/Instruction.java
+++ b/src/main/java/org/apache/bcel/generic/Instruction.java
@@ -72,6 +72,7 @@ public abstract class Instruction implements Cloneable {
* <p>
* If the Instruction is defined in {@link InstructionConst}, then the
singleton instance is returned.
* </p>
+ *
* @param bytes input stream bytes
* @return instruction object being read
* @throws IOException Thrown when an I/O exception of some sort has
occurred.
diff --git a/src/main/java/org/apache/bcel/generic/ObjectType.java
b/src/main/java/org/apache/bcel/generic/ObjectType.java
index 8a006cd6..5ebb8f4d 100644
--- a/src/main/java/org/apache/bcel/generic/ObjectType.java
+++ b/src/main/java/org/apache/bcel/generic/ObjectType.java
@@ -91,6 +91,7 @@ public class ObjectType extends ReferenceType {
/**
* If "this" doesn't reference a class, it references an interface or a
non-existant entity.
+ *
* @deprecated (since 6.0) this method returns an inaccurate result if the
class or interface referenced cannot be
* found: use referencesClassExact() instead
*/
diff --git a/src/main/java/org/apache/bcel/util/BCELifier.java
b/src/main/java/org/apache/bcel/util/BCELifier.java
index 20ef1ff0..46272ece 100644
--- a/src/main/java/org/apache/bcel/util/BCELifier.java
+++ b/src/main/java/org/apache/bcel/util/BCELifier.java
@@ -367,6 +367,7 @@ public class BCELifier extends
org.apache.bcel.classfile.EmptyVisitor {
/**
* Visits a {@link StackMapType} object.
+ *
* @param stackMapType object to visit
* @since 6.7.1
*/
diff --git a/src/main/java/org/apache/bcel/util/ClassPath.java
b/src/main/java/org/apache/bcel/util/ClassPath.java
index 2cf96fbe..64100877 100644
--- a/src/main/java/org/apache/bcel/util/ClassPath.java
+++ b/src/main/java/org/apache/bcel/util/ClassPath.java
@@ -672,6 +672,7 @@ public class ClassPath implements Closeable {
* <p>
* The caller is responsible for closing the InputStream.
* </p>
+ *
* @param name fully qualified class name, for example {@link String}.
* @return input stream for class
* @throws IOException if an I/O error occurs.