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-compress.git
The following commit(s) were added to refs/heads/master by this push: new 4e6b402ac Javadoc 4e6b402ac is described below commit 4e6b402acd2b632b4dfd475f9acb5d60ba272695 Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Fri Feb 21 17:53:24 2025 -0500 Javadoc --- .../compress/compressors/bzip2/BZip2Constants.java | 39 +++++++++++++++ .../commons/compress/harmony/pack200/BandSet.java | 2 +- .../harmony/pack200/CanonicalCodecFamilies.java | 57 ++++++++++++++++++++++ .../unpack200/bytecode/forms/ByteCodeForm.java | 8 +-- .../harmony/unpack200/bytecode/forms/ByteForm.java | 7 +++ .../unpack200/bytecode/forms/ClassRefForm.java | 15 ++++++ .../bytecode/forms/ClassSpecificReferenceForm.java | 7 +++ .../unpack200/bytecode/forms/DoubleForm.java | 7 +++ .../unpack200/bytecode/forms/FieldRefForm.java | 7 +++ .../unpack200/bytecode/forms/FloatRefForm.java | 15 ++++++ .../unpack200/bytecode/forms/IMethodRefForm.java | 7 +++ .../harmony/unpack200/bytecode/forms/IincForm.java | 7 +++ .../bytecode/forms/InitMethodReferenceForm.java | 7 +++ .../unpack200/bytecode/forms/IntRefForm.java | 15 ++++++ .../unpack200/bytecode/forms/LabelForm.java | 15 ++++++ .../unpack200/bytecode/forms/LocalForm.java | 7 +++ .../harmony/unpack200/bytecode/forms/LongForm.java | 7 +++ .../unpack200/bytecode/forms/LookupSwitchForm.java | 6 +++ .../unpack200/bytecode/forms/MethodRefForm.java | 7 +++ .../bytecode/forms/MultiANewArrayForm.java | 7 +++ .../bytecode/forms/NarrowClassRefForm.java | 15 ++++++ .../unpack200/bytecode/forms/NewClassRefForm.java | 7 +++ .../bytecode/forms/NewInitMethodRefForm.java | 7 +++ .../unpack200/bytecode/forms/NoArgumentForm.java | 6 +++ .../unpack200/bytecode/forms/ReferenceForm.java | 7 +++ .../unpack200/bytecode/forms/ShortForm.java | 7 +++ .../bytecode/forms/SingleByteReferenceForm.java | 7 +++ .../unpack200/bytecode/forms/StringRefForm.java | 15 ++++++ .../bytecode/forms/SuperFieldRefForm.java | 7 +++ .../bytecode/forms/SuperInitMethodRefForm.java | 7 +++ .../bytecode/forms/SuperMethodRefForm.java | 7 +++ .../unpack200/bytecode/forms/SwitchForm.java | 6 +++ .../unpack200/bytecode/forms/TableSwitchForm.java | 6 +++ .../unpack200/bytecode/forms/ThisFieldRefForm.java | 7 +++ .../bytecode/forms/ThisInitMethodRefForm.java | 7 +++ .../bytecode/forms/ThisMethodRefForm.java | 7 +++ .../bytecode/forms/VariableInstructionForm.java | 6 +++ .../harmony/unpack200/bytecode/forms/WideForm.java | 6 +++ .../apache/commons/compress/utils/ByteUtils.java | 10 ++++ 39 files changed, 391 insertions(+), 5 deletions(-) diff --git a/src/main/java/org/apache/commons/compress/compressors/bzip2/BZip2Constants.java b/src/main/java/org/apache/commons/compress/compressors/bzip2/BZip2Constants.java index 74529d906..9350d2100 100644 --- a/src/main/java/org/apache/commons/compress/compressors/bzip2/BZip2Constants.java +++ b/src/main/java/org/apache/commons/compress/compressors/bzip2/BZip2Constants.java @@ -24,15 +24,54 @@ */ interface BZip2Constants { + /** + * Constant {@value}. + */ int BASEBLOCKSIZE = 100_000; + + /** + * Constant {@value}. + */ int MAX_ALPHA_SIZE = 258; + + /** + * Constant {@value}. + */ int MAX_CODE_LEN = 23; + + /** + * Constant {@value}. + */ int RUNA = 0; + + /** + * Constant {@value}. + */ int RUNB = 1; + + /** + * Constant {@value}. + */ int N_GROUPS = 6; + + /** + * Constant {@value}. + */ int G_SIZE = 50; + + /** + * Constant {@value}. + */ int N_ITERS = 4; + + /** + * Constant {@value}. + */ int MAX_SELECTORS = 2 + 900_000 / G_SIZE; + + /** + * Constant {@value}. + */ int NUM_OVERSHOOT_BYTES = 20; } diff --git a/src/main/java/org/apache/commons/compress/harmony/pack200/BandSet.java b/src/main/java/org/apache/commons/compress/harmony/pack200/BandSet.java index b4e7f7ec3..c0ee1426a 100644 --- a/src/main/java/org/apache/commons/compress/harmony/pack200/BandSet.java +++ b/src/main/java/org/apache/commons/compress/harmony/pack200/BandSet.java @@ -84,7 +84,7 @@ public class BandData { private Map<Integer, Integer> distinctValues; /** - * Constructs a new instance of BandData. The band is then analysed. + * Constructs a new instance of BandData. The band is then analyzed. * * @param band the band of integers */ diff --git a/src/main/java/org/apache/commons/compress/harmony/pack200/CanonicalCodecFamilies.java b/src/main/java/org/apache/commons/compress/harmony/pack200/CanonicalCodecFamilies.java index db2bcb6e7..55b9c027c 100644 --- a/src/main/java/org/apache/commons/compress/harmony/pack200/CanonicalCodecFamilies.java +++ b/src/main/java/org/apache/commons/compress/harmony/pack200/CanonicalCodecFamilies.java @@ -26,6 +26,9 @@ public class CanonicalCodecFamilies { // Families of codecs for bands of positive integers that do not correlate // well (i.e. would not benefit from delta encoding) + /** + * Non-delta unsigned codecs 1. + */ public static BHSDCodec[] nonDeltaUnsignedCodecs1 = { // (1,256) is a special case and is considered separately so shouldn't be included here // CodecEncoding.getCanonicalCodec(1), // (1,256) @@ -34,6 +37,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(13) // (4,256) }; + /** + * Non-delta unsigned codecs 2. + */ public static BHSDCodec[] nonDeltaUnsignedCodecs2 = { CodecEncoding.getCanonicalCodec(17), // (5,4) CodecEncoding.getCanonicalCodec(20), // (5,16) CodecEncoding.getCanonicalCodec(23), // (5,32) @@ -41,6 +47,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(29) // (5,128) }; + /** + * Non-delta unsigned codecs 3. + */ public static BHSDCodec[] nonDeltaUnsignedCodecs3 = { CodecEncoding.getCanonicalCodec(47), // (2,192) CodecEncoding.getCanonicalCodec(48), // (2,224) CodecEncoding.getCanonicalCodec(49), // (2,240) @@ -48,6 +57,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(51) // (2,252) }; + /** + * Non-delta unsigned codecs 4. + */ public static BHSDCodec[] nonDeltaUnsignedCodecs4 = { CodecEncoding.getCanonicalCodec(70), // (3,192) CodecEncoding.getCanonicalCodec(71), // (3,224) CodecEncoding.getCanonicalCodec(72), // (3,240) @@ -55,6 +67,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(74) // (3,252) }; + /** + * Non-delta unsigned codecs 5. + */ public static BHSDCodec[] nonDeltaUnsignedCodecs5 = { CodecEncoding.getCanonicalCodec(93), // (4,192) CodecEncoding.getCanonicalCodec(94), // (4,224) CodecEncoding.getCanonicalCodec(95), // (4,240) @@ -65,12 +80,18 @@ public class CanonicalCodecFamilies { // Families of codecs for bands of positive integers that do correlate well // and would benefit from delta encoding + /** + * Delta unsigned codecs 1. + */ public static BHSDCodec[] deltaUnsignedCodecs1 = { CodecEncoding.getCanonicalCodec(3), // (1,256,0,1) CodecEncoding.getCanonicalCodec(7), // (2,256,0,1) CodecEncoding.getCanonicalCodec(11), // (3,256,0,1) CodecEncoding.getCanonicalCodec(15) // (4,256,0,1) }; + /** + * Delta unsigned codecs 2. + */ public static BHSDCodec[] deltaUnsignedCodecs2 = { CodecEncoding.getCanonicalCodec(32), // (5,4,0,1) CodecEncoding.getCanonicalCodec(35), // (5,16,0,1) CodecEncoding.getCanonicalCodec(38), // (5,32,0,1) @@ -78,6 +99,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(44) // (5,128,0,1) }; + /** + * Delta unsigned codecs 3. + */ public static BHSDCodec[] deltaUnsignedCodecs3 = { CodecEncoding.getCanonicalCodec(52), // (2,8,0,1) CodecEncoding.getCanonicalCodec(54), // (2,16,0,1) CodecEncoding.getCanonicalCodec(56), // (2,32,0,1) @@ -89,6 +113,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(68) // (2,248,0,1) }; + /** + * Delta unsigned codecs 4. + */ public static BHSDCodec[] deltaUnsignedCodecs4 = { CodecEncoding.getCanonicalCodec(75), // (3,8,0,1) CodecEncoding.getCanonicalCodec(77), // (3,16,0,1) CodecEncoding.getCanonicalCodec(79), // (3,32,0,1) @@ -100,6 +127,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(91) // (3,248,0,1) }; + /** + * Delta unsigned codecs 5. + */ public static BHSDCodec[] deltaUnsignedCodecs5 = { CodecEncoding.getCanonicalCodec(98), // (4,8,0,1) CodecEncoding.getCanonicalCodec(100), // (4,16,0,1) CodecEncoding.getCanonicalCodec(102), // (4,32,0,1) @@ -114,12 +144,18 @@ public class CanonicalCodecFamilies { // Families of codecs for bands containing positive and negative integers // that do correlate well (i.e. delta encoding is used) + /** + * Delta signed codecs 1. + */ public static BHSDCodec[] deltaSignedCodecs1 = { CodecEncoding.getCanonicalCodec(4), // (1,256,1,1) CodecEncoding.getCanonicalCodec(8), // (2,256,1,1) CodecEncoding.getCanonicalCodec(12), // (3,256,1,1) CodecEncoding.getCanonicalCodec(16) // (4,256,1,1) }; + /** + * Delta signed codecs 2. + */ public static BHSDCodec[] deltaSignedCodecs2 = { CodecEncoding.getCanonicalCodec(33), // (5,4,1,1) CodecEncoding.getCanonicalCodec(36), // (5,16,1,1) CodecEncoding.getCanonicalCodec(39), // (5,32,1,1) @@ -127,6 +163,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(45) // (5,128,1,1) }; + /** + * Delta signed codecs 3. + */ public static BHSDCodec[] deltaSignedCodecs3 = { CodecEncoding.getCanonicalCodec(53), // (2,8,1,1) CodecEncoding.getCanonicalCodec(55), // (2,16,1,1) CodecEncoding.getCanonicalCodec(57), // (2,32,1,1) @@ -138,6 +177,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(69) // (2,248,1,1) }; + /** + * Delta signed codecs 4. + */ public static BHSDCodec[] deltaSignedCodecs4 = { CodecEncoding.getCanonicalCodec(76), // (3,8,1,1) CodecEncoding.getCanonicalCodec(78), // (3,16,1,1) CodecEncoding.getCanonicalCodec(80), // (3,32,1,1) @@ -149,6 +191,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(92) // (3,248,1,1) }; + /** + * Delta signed codecs 5. + */ public static BHSDCodec[] deltaSignedCodecs5 = { CodecEncoding.getCanonicalCodec(99), // (4,8,1,1) CodecEncoding.getCanonicalCodec(101), // (4,16,1,1) CodecEncoding.getCanonicalCodec(103), // (4,32,1,1) @@ -160,6 +205,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(115) // (4,248,1,1) }; + /** + * Delta double signed codecs 1. + */ public static BHSDCodec[] deltaDoubleSignedCodecs1 = { CodecEncoding.getCanonicalCodec(34), // (5,4,2,1) CodecEncoding.getCanonicalCodec(37), // (5,16,2,1) CodecEncoding.getCanonicalCodec(40), // (5,32,2,1) @@ -170,12 +218,18 @@ public class CanonicalCodecFamilies { // Families of codecs for bands containing positive and negative values that // do not correlate well (i.e. delta encoding is not used) + /** + * Non-delta signed codecs 1. + */ public static BHSDCodec[] nonDeltaSignedCodecs1 = { CodecEncoding.getCanonicalCodec(2), // (1,256,1) CodecEncoding.getCanonicalCodec(6), // (2,256,1) CodecEncoding.getCanonicalCodec(10), // (3,256,1) CodecEncoding.getCanonicalCodec(14) // (4,256,1) }; + /** + * Non-delta signed codecs 2. + */ public static BHSDCodec[] nonDeltaSignedCodecs2 = { CodecEncoding.getCanonicalCodec(18), // (5,4,1) CodecEncoding.getCanonicalCodec(21), // (5,16,1) CodecEncoding.getCanonicalCodec(24), // (5,32,1) @@ -183,6 +237,9 @@ public class CanonicalCodecFamilies { CodecEncoding.getCanonicalCodec(30) // (5,128,1) }; + /** + * Non-delta double signed codecs 1. + */ public static BHSDCodec[] nonDeltaDoubleSignedCodecs1 = { CodecEncoding.getCanonicalCodec(19), // (5,4,2) CodecEncoding.getCanonicalCodec(22), // (5,16,2) CodecEncoding.getCanonicalCodec(25), // (5,32,2) diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ByteCodeForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ByteCodeForm.java index 8c2145849..c78a21cce 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ByteCodeForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ByteCodeForm.java @@ -316,8 +316,8 @@ public static ByteCodeForm get(final int opcode) { /** * Constructs a new instance with the specified opcode and name. Assume no rewrite. * - * @param opcode int corresponding to the opcode's value. - * @param name String printable name of the opcode. + * @param opcode index corresponding to the opcode's value. + * @param name printable name of the opcode. */ public ByteCodeForm(final int opcode, final String name) { this(opcode, name, new int[] { opcode }); @@ -326,9 +326,9 @@ public ByteCodeForm(final int opcode, final String name) { /** * Constructs a new instance with the specified opcode, name, operandType and rewrite. * - * @param opcode int corresponding to the opcode's value. + * @param opcode index corresponding to the opcode's value. * @param name String printable name of the opcode. - * @param rewrite int[] Array of ints. Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. */ public ByteCodeForm(final int opcode, final String name, final int[] rewrite) { this.opcode = opcode; diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ByteForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ByteForm.java index 403a98fdb..cdf1e105f 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ByteForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ByteForm.java @@ -26,6 +26,13 @@ */ public class ByteForm extends ByteCodeForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public ByteForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ClassRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ClassRefForm.java index 033632638..4c452d508 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ClassRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ClassRefForm.java @@ -31,10 +31,25 @@ public class ClassRefForm extends ReferenceForm { protected boolean widened; + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public ClassRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + * @param widened TODO. + */ public ClassRefForm(final int opcode, final String name, final int[] rewrite, final boolean widened) { this(opcode, name, rewrite); this.widened = widened; diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ClassSpecificReferenceForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ClassSpecificReferenceForm.java index 529ef3ea2..557cd1316 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ClassSpecificReferenceForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ClassSpecificReferenceForm.java @@ -30,6 +30,13 @@ */ public abstract class ClassSpecificReferenceForm extends ReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public ClassSpecificReferenceForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/DoubleForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/DoubleForm.java index b07f4873e..5ea512c8c 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/DoubleForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/DoubleForm.java @@ -26,6 +26,13 @@ */ public class DoubleForm extends ReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public DoubleForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/FieldRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/FieldRefForm.java index e27ea7f0d..1bd97afd0 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/FieldRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/FieldRefForm.java @@ -26,6 +26,13 @@ */ public class FieldRefForm extends ReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public FieldRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/FloatRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/FloatRefForm.java index 8a01771e5..ff092c95b 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/FloatRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/FloatRefForm.java @@ -26,10 +26,25 @@ */ public class FloatRefForm extends SingleByteReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public FloatRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + * @param widened TODO. + */ public FloatRefForm(final int opcode, final String name, final int[] rewrite, final boolean widened) { this(opcode, name, rewrite); this.widened = widened; diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IMethodRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IMethodRefForm.java index 6a81ef57f..4e47c4873 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IMethodRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IMethodRefForm.java @@ -28,6 +28,13 @@ */ public class IMethodRefForm extends ReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public IMethodRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IincForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IincForm.java index d22b9b6f6..929b9a723 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IincForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IincForm.java @@ -26,6 +26,13 @@ */ public class IincForm extends ByteCodeForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public IincForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/InitMethodReferenceForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/InitMethodReferenceForm.java index 4ae9f432a..f05ac8fdc 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/InitMethodReferenceForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/InitMethodReferenceForm.java @@ -29,6 +29,13 @@ */ public abstract class InitMethodReferenceForm extends ClassSpecificReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public InitMethodReferenceForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IntRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IntRefForm.java index 1b6a7a874..b0c8f79ea 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IntRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/IntRefForm.java @@ -26,10 +26,25 @@ */ public class IntRefForm extends SingleByteReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public IntRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + * @param widened TODO. + */ public IntRefForm(final int opcode, final String name, final int[] rewrite, final boolean widened) { this(opcode, name, rewrite); this.widened = widened; diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LabelForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LabelForm.java index 5254300a9..8f73ec0e0 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LabelForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LabelForm.java @@ -29,10 +29,25 @@ public class LabelForm extends ByteCodeForm { protected boolean widened; + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public LabelForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + * @param widened TODO. + */ public LabelForm(final int opcode, final String name, final int[] rewrite, final boolean widened) { this(opcode, name, rewrite); this.widened = widened; diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LocalForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LocalForm.java index 31a6fd2f9..12400df70 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LocalForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LocalForm.java @@ -27,6 +27,13 @@ */ public class LocalForm extends ByteCodeForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public LocalForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LongForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LongForm.java index a3afe0f07..92c9fe52c 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LongForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LongForm.java @@ -26,6 +26,13 @@ */ public class LongForm extends ReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public LongForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LookupSwitchForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LookupSwitchForm.java index 4b518e1e0..eceace60c 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LookupSwitchForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/LookupSwitchForm.java @@ -25,6 +25,12 @@ public class LookupSwitchForm extends SwitchForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + */ public LookupSwitchForm(final int opcode, final String name) { super(opcode, name); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/MethodRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/MethodRefForm.java index 19fc125ca..152609110 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/MethodRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/MethodRefForm.java @@ -27,6 +27,13 @@ */ public class MethodRefForm extends ReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public MethodRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/MultiANewArrayForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/MultiANewArrayForm.java index 990d85c85..d59a13f1a 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/MultiANewArrayForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/MultiANewArrayForm.java @@ -28,6 +28,13 @@ */ public class MultiANewArrayForm extends ClassRefForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public MultiANewArrayForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NarrowClassRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NarrowClassRefForm.java index ed9659879..6d51856d7 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NarrowClassRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NarrowClassRefForm.java @@ -27,10 +27,25 @@ */ public class NarrowClassRefForm extends ClassRefForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public NarrowClassRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + * @param widened TODO. + */ public NarrowClassRefForm(final int opcode, final String name, final int[] rewrite, final boolean widened) { super(opcode, name, rewrite, widened); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NewClassRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NewClassRefForm.java index 691646a94..8e1e4544a 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NewClassRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NewClassRefForm.java @@ -31,6 +31,13 @@ */ public class NewClassRefForm extends ClassRefForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public NewClassRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NewInitMethodRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NewInitMethodRefForm.java index b8697f008..cf025d906 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NewInitMethodRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NewInitMethodRefForm.java @@ -29,6 +29,13 @@ */ public class NewInitMethodRefForm extends InitMethodReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public NewInitMethodRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NoArgumentForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NoArgumentForm.java index 52c67d4c8..bc105c6be 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NoArgumentForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/NoArgumentForm.java @@ -27,6 +27,12 @@ */ public class NoArgumentForm extends ByteCodeForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + */ public NoArgumentForm(final int opcode, final String name) { super(opcode, name); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ReferenceForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ReferenceForm.java index 8ca469277..0cf63d838 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ReferenceForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ReferenceForm.java @@ -31,6 +31,13 @@ */ public abstract class ReferenceForm extends ByteCodeForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public ReferenceForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ShortForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ShortForm.java index a74f3a4c0..814688028 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ShortForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ShortForm.java @@ -26,6 +26,13 @@ */ public class ShortForm extends ByteCodeForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public ShortForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SingleByteReferenceForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SingleByteReferenceForm.java index dadea3947..412b97fef 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SingleByteReferenceForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SingleByteReferenceForm.java @@ -29,6 +29,13 @@ public abstract class SingleByteReferenceForm extends ReferenceForm { protected boolean widened; + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public SingleByteReferenceForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/StringRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/StringRefForm.java index 840cd6bb8..d8682c5ac 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/StringRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/StringRefForm.java @@ -29,10 +29,25 @@ */ public class StringRefForm extends SingleByteReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public StringRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + * @param widened TODO. + */ public StringRefForm(final int opcode, final String name, final int[] rewrite, final boolean widened) { this(opcode, name, rewrite); this.widened = widened; diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperFieldRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperFieldRefForm.java index a9c673afe..845bc2c62 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperFieldRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperFieldRefForm.java @@ -27,6 +27,13 @@ */ public class SuperFieldRefForm extends ClassSpecificReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public SuperFieldRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperInitMethodRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperInitMethodRefForm.java index 71b677f42..2a14f0f6e 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperInitMethodRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperInitMethodRefForm.java @@ -23,6 +23,13 @@ */ public class SuperInitMethodRefForm extends InitMethodReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public SuperInitMethodRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperMethodRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperMethodRefForm.java index b667567b9..79b3feb6d 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperMethodRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SuperMethodRefForm.java @@ -27,6 +27,13 @@ */ public class SuperMethodRefForm extends ClassSpecificReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public SuperMethodRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SwitchForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SwitchForm.java index dcc6de2ff..ff3fe7f49 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SwitchForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/SwitchForm.java @@ -23,6 +23,12 @@ public abstract class SwitchForm extends VariableInstructionForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + */ public SwitchForm(final int opcode, final String name) { super(opcode, name); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/TableSwitchForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/TableSwitchForm.java index a4fc0d90d..7e2271160 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/TableSwitchForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/TableSwitchForm.java @@ -25,6 +25,12 @@ public class TableSwitchForm extends SwitchForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + */ public TableSwitchForm(final int opcode, final String name) { super(opcode, name); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisFieldRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisFieldRefForm.java index a6da781f4..90b8a611d 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisFieldRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisFieldRefForm.java @@ -27,6 +27,13 @@ */ public class ThisFieldRefForm extends ClassSpecificReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public ThisFieldRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisInitMethodRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisInitMethodRefForm.java index d676c41f7..c3364775f 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisInitMethodRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisInitMethodRefForm.java @@ -25,6 +25,13 @@ */ public class ThisInitMethodRefForm extends InitMethodReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public ThisInitMethodRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisMethodRefForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisMethodRefForm.java index a236e852a..714a4f7f9 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisMethodRefForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/ThisMethodRefForm.java @@ -27,6 +27,13 @@ */ public class ThisMethodRefForm extends ClassSpecificReferenceForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + * @param rewrite Operand positions (which will later be rewritten in ByteCodes) are indicated by -1. + */ public ThisMethodRefForm(final int opcode, final String name, final int[] rewrite) { super(opcode, name, rewrite); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/VariableInstructionForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/VariableInstructionForm.java index 6b3ed2c7b..cf0ee8548 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/VariableInstructionForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/VariableInstructionForm.java @@ -24,6 +24,12 @@ */ public abstract class VariableInstructionForm extends ByteCodeForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + */ public VariableInstructionForm(final int opcode, final String name) { super(opcode, name); } diff --git a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/WideForm.java b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/WideForm.java index 0281207a0..e748f8e82 100644 --- a/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/WideForm.java +++ b/src/main/java/org/apache/commons/compress/harmony/unpack200/bytecode/forms/WideForm.java @@ -26,6 +26,12 @@ */ public class WideForm extends VariableInstructionForm { + /** + * Constructs a new instance with the specified opcode, name, operandType and rewrite. + * + * @param opcode index corresponding to the opcode's value. + * @param name String printable name of the opcode. + */ public WideForm(final int opcode, final String name) { super(opcode, name); } diff --git a/src/main/java/org/apache/commons/compress/utils/ByteUtils.java b/src/main/java/org/apache/commons/compress/utils/ByteUtils.java index 32f97c715..32682bbca 100644 --- a/src/main/java/org/apache/commons/compress/utils/ByteUtils.java +++ b/src/main/java/org/apache/commons/compress/utils/ByteUtils.java @@ -72,6 +72,11 @@ public interface ByteSupplier { public static class InputStreamByteSupplier implements ByteSupplier { private final InputStream is; + /** + * Constructs a new instance. + * + * @param is an input stream. + */ public InputStreamByteSupplier(final InputStream is) { this.is = is; } @@ -90,6 +95,11 @@ public int getAsByte() throws IOException { public static class OutputStreamByteConsumer implements ByteConsumer { private final OutputStream os; + /** + * Constructs a new instance. + * + * @param os an output stream. + */ public OutputStreamByteConsumer(final OutputStream os) { this.os = os; }