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 465b689a No need for blank Javadoc lines between Javadoc @ tags
new 30ba7660 Merge branch 'master' of
https://gitbox.apache.org/repos/asf/commons-bcel.git
465b689a is described below
commit 465b689a394beef799720bde3d58df9377cf80b9
Author: Gary David Gregory (Code signing key) <ggreg...@apache.org>
AuthorDate: Thu Nov 28 11:28:46 2024 -0500
No need for blank Javadoc lines between Javadoc @ tags
---
src/main/java/org/apache/bcel/classfile/Attribute.java | 2 --
src/main/java/org/apache/bcel/classfile/AttributeReader.java | 3 ---
src/main/java/org/apache/bcel/classfile/Code.java | 1 -
src/main/java/org/apache/bcel/classfile/LocalVariable.java | 1 -
src/main/java/org/apache/bcel/classfile/LocalVariableTable.java | 2 --
src/main/java/org/apache/bcel/classfile/StackMap.java | 2 --
.../java/org/apache/bcel/classfile/UnknownAttributeReader.java | 1 -
src/main/java/org/apache/bcel/classfile/Utility.java | 9 ---------
src/main/java/org/apache/bcel/util/ModularRuntimeImage.java | 1 -
.../java/org/apache/bcel/verifier/statics/LocalVariableInfo.java | 1 -
.../java/org/apache/bcel/verifier/structurals/Subroutine.java | 2 --
11 files changed, 25 deletions(-)
diff --git a/src/main/java/org/apache/bcel/classfile/Attribute.java
b/src/main/java/org/apache/bcel/classfile/Attribute.java
index 0dd994c2..8caf5311 100644
--- a/src/main/java/org/apache/bcel/classfile/Attribute.java
+++ b/src/main/java/org/apache/bcel/classfile/Attribute.java
@@ -100,7 +100,6 @@ public abstract class Attribute implements Cloneable, Node {
*
* @see Field
* @see Method
- *
* @param dataInput Input stream
* @param constantPool Array of constants
* @return Attribute
@@ -205,7 +204,6 @@ public abstract class Attribute implements Cloneable, Node {
*
* @see Field
* @see Method
- *
* @param dataInputStream Input stream
* @param constantPool Array of constants
* @return Attribute
diff --git a/src/main/java/org/apache/bcel/classfile/AttributeReader.java
b/src/main/java/org/apache/bcel/classfile/AttributeReader.java
index d1363cec..1b4a2ade 100644
--- a/src/main/java/org/apache/bcel/classfile/AttributeReader.java
+++ b/src/main/java/org/apache/bcel/classfile/AttributeReader.java
@@ -21,7 +21,6 @@ package org.apache.bcel.classfile;
* Attribute.addAttributeReader method. These factory objects should implement
this interface.
*
* @see Attribute
- *
* @deprecated Use UnknownAttributeReader instead
*/
@java.lang.Deprecated
@@ -33,12 +32,10 @@ public interface AttributeReader {
* name of the attributes it is constructing.
*
* @param nameIndex An index into the constant pool, indexing a
ConstantUtf8 that represents the name of the attribute.
- *
* @param length The length of the data contained in the attribute. This
is written into the constant pool and should
* agree with what the factory expects the length to be.
*
* @param file This is the data input stream that the factory needs to
read its data from.
- *
* @param constantPool This is the constant pool associated with the
Attribute that we are constructing.
*
* @return The user-defined AttributeReader should take this data and use
it to construct an attribute. In the case of
diff --git a/src/main/java/org/apache/bcel/classfile/Code.java
b/src/main/java/org/apache/bcel/classfile/Code.java
index e20b70d1..3f50d5a1 100644
--- a/src/main/java/org/apache/bcel/classfile/Code.java
+++ b/src/main/java/org/apache/bcel/classfile/Code.java
@@ -161,7 +161,6 @@ public final class Code extends Attribute {
/**
* @return deep copy of this attribute
- *
* @param constantPool the constant pool to duplicate
*/
@Override
diff --git a/src/main/java/org/apache/bcel/classfile/LocalVariable.java
b/src/main/java/org/apache/bcel/classfile/LocalVariable.java
index 1cb011e5..70241e4c 100644
--- a/src/main/java/org/apache/bcel/classfile/LocalVariable.java
+++ b/src/main/java/org/apache/bcel/classfile/LocalVariable.java
@@ -31,7 +31,6 @@ import org.apache.bcel.util.Args;
* LocalVariableTypeTable attribute does have a signatureIndex.
*
* @see org.apache.bcel.classfile.Utility for more details on the difference.
- *
* @see LocalVariableTable
* @see LocalVariableTypeTable
*/
diff --git a/src/main/java/org/apache/bcel/classfile/LocalVariableTable.java
b/src/main/java/org/apache/bcel/classfile/LocalVariableTable.java
index b73e99c2..2a730e96 100644
--- a/src/main/java/org/apache/bcel/classfile/LocalVariableTable.java
+++ b/src/main/java/org/apache/bcel/classfile/LocalVariableTable.java
@@ -120,7 +120,6 @@ public class LocalVariableTable extends Attribute
implements Iterable<LocalVaria
/**
*
* @param index the variable slot
- *
* @return the first LocalVariable that matches the slot or null if not
found
*
* @deprecated since 5.2 because multiple variables can share the same
slot, use getLocalVariable(int index, int pc)
@@ -140,7 +139,6 @@ public class LocalVariableTable extends Attribute
implements Iterable<LocalVaria
*
* @param index the variable slot
* @param pc the current pc that this variable is alive
- *
* @return the LocalVariable that matches or null if not found
*/
public final LocalVariable getLocalVariable(final int index, final int pc)
{
diff --git a/src/main/java/org/apache/bcel/classfile/StackMap.java
b/src/main/java/org/apache/bcel/classfile/StackMap.java
index 1176f80e..c69119f0 100644
--- a/src/main/java/org/apache/bcel/classfile/StackMap.java
+++ b/src/main/java/org/apache/bcel/classfile/StackMap.java
@@ -67,11 +67,9 @@ public final class StackMap extends Attribute {
/*
* @param nameIndex Index of name
- *
* @param length Content length in bytes
*
* @param map Table of stack map entries
- *
* @param constantPool Array of constants
*/
public StackMap(final int nameIndex, final int length, final
StackMapEntry[] table, final ConstantPool constantPool) {
diff --git
a/src/main/java/org/apache/bcel/classfile/UnknownAttributeReader.java
b/src/main/java/org/apache/bcel/classfile/UnknownAttributeReader.java
index 109470a5..5ff3ad5a 100644
--- a/src/main/java/org/apache/bcel/classfile/UnknownAttributeReader.java
+++ b/src/main/java/org/apache/bcel/classfile/UnknownAttributeReader.java
@@ -36,7 +36,6 @@ public interface UnknownAttributeReader {
* agree with what the factory expects the length to be.
* @param file This is the data input that the factory needs to read its
data from.
* @param constantPool This is the constant pool associated with the
Attribute that we are constructing.
- *
* @return The user-defined AttributeReader should take this data and use
it to construct an attribute. In the case of
* errors, a null can be returned which will cause the parsing of
the class file to fail.
*
diff --git a/src/main/java/org/apache/bcel/classfile/Utility.java
b/src/main/java/org/apache/bcel/classfile/Utility.java
index 00ff6284..d6a85fcb 100644
--- a/src/main/java/org/apache/bcel/classfile/Utility.java
+++ b/src/main/java/org/apache/bcel/classfile/Utility.java
@@ -219,7 +219,6 @@ public abstract class Utility {
/**
* @param accessFlags the class flags
- *
* @return "class" or "interface", depending on the ACC_INTERFACE flag
*/
public static String classOrInterface(final int accessFlags) {
@@ -278,7 +277,6 @@ public abstract class Utility {
* @param constantPool Array of constants
* @param verbose be verbose, e.g. print constant pool index
* @return String representation of byte code
- *
* @throws IOException if a failure from reading from the bytes argument
occurs
*/
public static String codeToString(final ByteSequence bytes, final
ConstantPool constantPool, final boolean verbose) throws IOException {
@@ -643,7 +641,6 @@ public abstract class Utility {
*
* @param s the string to convert
* @param uncompress use gzip to uncompress the stream of bytes
- *
* @throws IOException if there's a gzip exception
*/
public static byte[] decode(final String s, final boolean uncompress)
throws IOException {
@@ -684,7 +681,6 @@ public abstract class Utility {
*
* @param bytes the byte array to convert
* @param compress use gzip to minimize string
- *
* @throws IOException if there's a gzip exception
*/
public static String encode(byte[] bytes, final boolean compress) throws
IOException {
@@ -821,7 +817,6 @@ public abstract class Utility {
/**
* @param ch the character to test if it's part of an identifier
- *
* @return true, if character is one of (a, ... z, A, ... Z, 0, ... 9, _)
*/
public static boolean isJavaIdentifierPart(final char ch) {
@@ -999,7 +994,6 @@ public abstract class Utility {
* @param ret Return type of method
* @param argv Types of method arguments
* @return Byte code representation of method signature
- *
* @throws ClassFormatException if the signature is for Void
*/
public static String methodTypeToSignature(final String ret, final
String[] argv) throws ClassFormatException {
@@ -1202,7 +1196,6 @@ public abstract class Utility {
* Convert bytes into hexadecimal string
*
* @param bytes an array of bytes to convert to hexadecimal
- *
* @return bytes as hexadecimal string, e.g. 00 fa 12 ...
*/
public static String toHexString(final byte[] bytes) {
@@ -1227,7 +1220,6 @@ public abstract class Utility {
* @param signature in format described above
* @return type of method signature
* @see Const
- *
* @throws ClassFormatException if signature is not a method signature
*/
public static byte typeOfMethodSignature(final String signature) throws
ClassFormatException {
@@ -1249,7 +1241,6 @@ public abstract class Utility {
* @param signature in format described above
* @return type of signature
* @see Const
- *
* @throws ClassFormatException if signature isn't a known type
*/
public static byte typeOfSignature(final String signature) throws
ClassFormatException {
diff --git a/src/main/java/org/apache/bcel/util/ModularRuntimeImage.java
b/src/main/java/org/apache/bcel/util/ModularRuntimeImage.java
index 47b6c936..5063fe0b 100644
--- a/src/main/java/org/apache/bcel/util/ModularRuntimeImage.java
+++ b/src/main/java/org/apache/bcel/util/ModularRuntimeImage.java
@@ -58,7 +58,6 @@ public class ModularRuntimeImage implements Closeable {
* Constructs an instance using the JRT file system implementation from a
specific Java Home.
*
* @param javaHome Path to a Java 9 or greater home.
- *
* @throws IOException an I/O error occurs accessing the file system
*/
public ModularRuntimeImage(final String javaHome) throws IOException {
diff --git
a/src/main/java/org/apache/bcel/verifier/statics/LocalVariableInfo.java
b/src/main/java/org/apache/bcel/verifier/statics/LocalVariableInfo.java
index d9673d3a..81174b6f 100644
--- a/src/main/java/org/apache/bcel/verifier/statics/LocalVariableInfo.java
+++ b/src/main/java/org/apache/bcel/verifier/statics/LocalVariableInfo.java
@@ -58,7 +58,6 @@ public class LocalVariableInfo {
* @param startPc Range in which the variable is valid.
* @param length length of ...
* @param type variable type
- *
* @throws LocalVariableInfoInconsistentException if the new information
conflicts with already gathered information.
*/
public void add(final String name, final int startPc, final int length,
final Type type) throws LocalVariableInfoInconsistentException {
diff --git a/src/main/java/org/apache/bcel/verifier/structurals/Subroutine.java
b/src/main/java/org/apache/bcel/verifier/structurals/Subroutine.java
index b7ab308b..c09dfc23 100644
--- a/src/main/java/org/apache/bcel/verifier/structurals/Subroutine.java
+++ b/src/main/java/org/apache/bcel/verifier/structurals/Subroutine.java
@@ -30,7 +30,6 @@ public interface Subroutine {
*
* @param inst The InstructionHandle to test.
* @return Whether the given InstructionHandle refers to an instruction
that is part of this subroutine.
- *
* @see #getInstructions()
*/
boolean contains(InstructionHandle inst);
@@ -66,7 +65,6 @@ public interface Subroutine {
* <B>Must not be invoked on the 'top-level subroutine'.</B>
*
* @return The one and only RET that leaves the subroutine.
- *
* @see Subroutines
*/
InstructionHandle getLeavingRET();
