This is an automated email from the ASF dual-hosted git repository.
garydgregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-imaging.git
The following commit(s) were added to refs/heads/master by this push:
new f13c55c4 Javadoc
f13c55c4 is described below
commit f13c55c4c6fcd78b5f5ad26e4d642aba10d90ae4
Author: Gary Gregory <[email protected]>
AuthorDate: Sun Aug 2 15:42:09 2026 -0400
Javadoc
---
.../org/apache/commons/imaging/ColorTools.java | 2 +-
.../java/org/apache/commons/imaging/ImageDump.java | 6 ++---
.../java/org/apache/commons/imaging/Imaging.java | 2 +-
.../commons/imaging/bytesource/ByteSource.java | 10 ++++-----
.../imaging/common/AbstractBinaryOutputStream.java | 6 ++---
.../commons/imaging/common/BasicCParser.java | 4 ++--
.../commons/imaging/common/BinaryConstant.java | 2 +-
.../commons/imaging/common/BinaryFunctions.java | 26 +++++++++++-----------
.../apache/commons/imaging/common/PackBits.java | 2 +-
.../imaging/formats/bmp/BmpImageParser.java | 2 +-
.../imaging/formats/jpeg/JpegImageParser.java | 16 ++++++-------
.../commons/imaging/formats/jpeg/JpegUtils.java | 6 ++---
.../imaging/formats/jpeg/decoder/JpegDecoder.java | 2 +-
.../imaging/formats/jpeg/iptc/IptcParser.java | 12 +++++-----
.../jpeg/segments/AbstractGenericSegment.java | 2 +-
.../formats/jpeg/segments/App13Segment.java | 6 ++---
.../formats/jpeg/segments/App14Segment.java | 4 ++--
.../imaging/formats/jpeg/segments/App2Segment.java | 4 ++--
.../imaging/formats/jpeg/segments/AppnSegment.java | 2 +-
.../imaging/formats/jpeg/segments/ComSegment.java | 2 +-
.../imaging/formats/jpeg/segments/DhtSegment.java | 4 ++--
.../imaging/formats/jpeg/segments/DqtSegment.java | 4 ++--
.../imaging/formats/jpeg/segments/SofnSegment.java | 4 ++--
.../imaging/formats/jpeg/segments/SosSegment.java | 4 ++--
.../formats/jpeg/segments/UnknownSegment.java | 2 +-
.../imaging/formats/jpeg/xmp/JpegRewriter.java | 6 ++---
.../imaging/formats/png/PngImageParser.java | 2 +-
.../imaging/formats/png/chunks/PngChunkGama.java | 2 +-
.../imaging/formats/png/chunks/PngChunkIhdr.java | 2 +-
.../imaging/formats/png/chunks/PngChunkPhys.java | 2 +-
.../imaging/formats/png/chunks/PngChunkPlte.java | 2 +-
.../imaging/formats/png/chunks/PngChunkZtxt.java | 2 +-
.../png/scanlinefilters/ScanlineFilter.java | 2 +-
.../AbstractTransparencyFilter.java | 2 +-
.../TransparencyFilterGrayscale.java | 2 +-
.../TransparencyFilterTrueColor.java | 2 +-
.../formats/psd/datareaders/DataReader.java | 2 +-
.../formats/tiff/AbstractTiffImageData.java | 2 +-
.../imaging/formats/tiff/TiffImageMetadata.java | 2 +-
.../imaging/formats/tiff/TiffImageParser.java | 4 ++--
.../commons/imaging/formats/tiff/TiffReader.java | 8 +++----
.../tiff/datareaders/AbstractImageDataReader.java | 2 +-
.../AbstractPhotometricInterpreter.java | 2 +-
.../tiff/write/AbstractTiffImageWriter.java | 8 +++----
.../formats/tiff/write/AbstractTiffOutputItem.java | 2 +-
.../formats/tiff/write/TiffOutputField.java | 2 +-
.../apache/commons/imaging/icc/IccProfileInfo.java | 2 +-
.../commons/imaging/icc/IccProfileParser.java | 16 ++++++-------
.../org/apache/commons/imaging/icc/IccTag.java | 6 ++---
.../apache/commons/imaging/icc/IccTagDataType.java | 2 +-
.../imaging/internal/ImageParserFactory.java | 2 +-
.../imaging/mylzw/BitsToByteInputStream.java | 4 ++--
.../commons/imaging/mylzw/MyBitInputStream.java | 2 +-
.../commons/imaging/mylzw/MyLzwCompressor.java | 2 +-
.../commons/imaging/mylzw/MyLzwDecompressor.java | 2 +-
.../commons/imaging/formats/gif/GifReadTest.java | 6 ++---
.../jpeg/exif/ExifRewriterRoundtripTest.java | 4 ++--
.../commons/imaging/formats/jpeg/exif/GpsTest.java | 2 +-
.../jpeg/exif/WriteExifMetadataExampleTest.java | 2 +-
.../commons/imaging/formats/png/PngReadTest.java | 6 ++---
.../commons/imaging/formats/webp/WebPDumpTest.java | 2 +-
.../imaging/formats/webp/WebPMetadataTest.java | 6 ++---
.../commons/imaging/formats/webp/WebPReadTest.java | 4 ++--
63 files changed, 133 insertions(+), 133 deletions(-)
diff --git a/src/main/java/org/apache/commons/imaging/ColorTools.java
b/src/main/java/org/apache/commons/imaging/ColorTools.java
index e82635bd..6ca7e568 100644
--- a/src/main/java/org/apache/commons/imaging/ColorTools.java
+++ b/src/main/java/org/apache/commons/imaging/ColorTools.java
@@ -178,7 +178,7 @@ public class ColorTools {
* @param file The file containing the ICC profile.
* @return The corrected image.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public BufferedImage correctImage(final BufferedImage src, final File
file) throws ImagingException, IOException {
final ICC_Profile icc = Imaging.getIccProfile(file);
diff --git a/src/main/java/org/apache/commons/imaging/ImageDump.java
b/src/main/java/org/apache/commons/imaging/ImageDump.java
index 169af392..64dc7412 100644
--- a/src/main/java/org/apache/commons/imaging/ImageDump.java
+++ b/src/main/java/org/apache/commons/imaging/ImageDump.java
@@ -44,7 +44,7 @@ public class ImageDump {
* Dumps image information.
*
* @param src The source image.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public void dump(final BufferedImage src) throws IOException {
dump(StringUtils.EMPTY, src);
@@ -55,7 +55,7 @@ public class ImageDump {
*
* @param prefix The prefix for output.
* @param src The source image.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public void dump(final String prefix, final BufferedImage src) throws
IOException {
LOGGER.fine(prefix + ": dump");
@@ -85,7 +85,7 @@ public class ImageDump {
*
* @param prefix The prefix for output.
* @param cs The color space.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public void dumpColorSpace(final String prefix, final ColorSpace cs)
throws IOException {
LOGGER.fine(prefix + ": type: " + cs.getType() + " (" + toName(cs) +
")");
diff --git a/src/main/java/org/apache/commons/imaging/Imaging.java
b/src/main/java/org/apache/commons/imaging/Imaging.java
index 5eb6df9e..8af199d6 100644
--- a/src/main/java/org/apache/commons/imaging/Imaging.java
+++ b/src/main/java/org/apache/commons/imaging/Imaging.java
@@ -316,7 +316,7 @@ public final class Imaging {
* @param byteSource The byte source.
* @return The ICC profile, or null if not found.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
protected static ICC_Profile getIccProfile(final ByteSource byteSource)
throws ImagingException, IOException {
final byte[] bytes = getIccProfileBytes(byteSource);
diff --git
a/src/main/java/org/apache/commons/imaging/bytesource/ByteSource.java
b/src/main/java/org/apache/commons/imaging/bytesource/ByteSource.java
index baf0cafd..9bca9311 100644
--- a/src/main/java/org/apache/commons/imaging/bytesource/ByteSource.java
+++ b/src/main/java/org/apache/commons/imaging/bytesource/ByteSource.java
@@ -71,7 +71,7 @@ public class ByteSource {
* @param byteSource The byte source.
* @param skip The number of bytes to skip.
* @return The input stream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static final InputStream getInputStream(final ByteSource
byteSource, final long skip) throws IOException {
InputStream is = null;
@@ -94,7 +94,7 @@ public class ByteSource {
* @param is The input stream.
* @param name The name.
* @return The ByteSource.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static ByteSource inputStream(final InputStream is, final String
name) throws IOException {
return new InputStreamByteSource(is, name);
@@ -130,7 +130,7 @@ public class ByteSource {
* @param position The position.
* @param length The length.
* @return The byte array.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public byte[] getByteArray(final long position, final int length) throws
IOException {
return origin.getByteArray(position, length);
@@ -149,7 +149,7 @@ public class ByteSource {
* Gets an input stream.
*
* @return The input stream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public InputStream getInputStream() throws IOException {
return origin.getInputStream();
@@ -159,7 +159,7 @@ public class ByteSource {
* This operation can be VERY expensive; for InputStream byte sources, the
entire stream must be drained to determine its length.
*
* @return The length.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public long size() throws IOException {
return origin.size();
diff --git
a/src/main/java/org/apache/commons/imaging/common/AbstractBinaryOutputStream.java
b/src/main/java/org/apache/commons/imaging/common/AbstractBinaryOutputStream.java
index 0f186ca5..f3bbcf88 100644
---
a/src/main/java/org/apache/commons/imaging/common/AbstractBinaryOutputStream.java
+++
b/src/main/java/org/apache/commons/imaging/common/AbstractBinaryOutputStream.java
@@ -81,7 +81,7 @@ public abstract class AbstractBinaryOutputStream extends
FilterOutputStream {
* Writes a 2-byte value.
*
* @param value The value to write.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public abstract void write2Bytes(int value) throws IOException;
@@ -89,7 +89,7 @@ public abstract class AbstractBinaryOutputStream extends
FilterOutputStream {
* Writes a 3-byte value.
*
* @param value The value to write.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public abstract void write3Bytes(int value) throws IOException;
@@ -97,7 +97,7 @@ public abstract class AbstractBinaryOutputStream extends
FilterOutputStream {
* Writes a 4-byte value.
*
* @param value The value to write.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public abstract void write4Bytes(int value) throws IOException;
}
diff --git a/src/main/java/org/apache/commons/imaging/common/BasicCParser.java
b/src/main/java/org/apache/commons/imaging/common/BasicCParser.java
index 5030b5ec..5622559d 100644
--- a/src/main/java/org/apache/commons/imaging/common/BasicCParser.java
+++ b/src/main/java/org/apache/commons/imaging/common/BasicCParser.java
@@ -167,7 +167,7 @@ public class BasicCParser {
* @param firstComment StringBuilder to capture the first comment, or null
to ignore.
* @param defines map to store preprocessor definitions.
* @return The preprocessed output as a ByteArrayOutputStream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
* @throws ImagingException if parsing fails.
*/
public static ByteArrayOutputStream preprocess(final InputStream is, final
StringBuilder firstComment, final Map<String, String> defines)
@@ -422,7 +422,7 @@ public class BasicCParser {
* Reads the next token from the input stream.
*
* @return The next token as a string, or null if end of stream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
* @throws ImagingException if parsing fails.
*/
public String nextToken() throws IOException, ImagingException {
diff --git
a/src/main/java/org/apache/commons/imaging/common/BinaryConstant.java
b/src/main/java/org/apache/commons/imaging/common/BinaryConstant.java
index 8dfd4b4b..aac6a936 100644
--- a/src/main/java/org/apache/commons/imaging/common/BinaryConstant.java
+++ b/src/main/java/org/apache/commons/imaging/common/BinaryConstant.java
@@ -104,7 +104,7 @@ public class BinaryConstant {
* Writes this binary constant to an output stream.
*
* @param os The output stream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public void writeTo(final OutputStream os) throws IOException {
for (final byte element : value) {
diff --git
a/src/main/java/org/apache/commons/imaging/common/BinaryFunctions.java
b/src/main/java/org/apache/commons/imaging/common/BinaryFunctions.java
index c829b5f8..67a122f9 100644
--- a/src/main/java/org/apache/commons/imaging/common/BinaryFunctions.java
+++ b/src/main/java/org/apache/commons/imaging/common/BinaryFunctions.java
@@ -110,7 +110,7 @@ public final class BinaryFunctions {
* @param length The number of bytes to read.
* @param exception The exception message if length is invalid.
* @return The bytes read.
- * @throws IOException if an I/O error occurs or length is invalid.
+ * @throws IOException Thrown if an I/O error occurs or length is invalid.
*/
public static byte[] getBytes(final RandomAccessFile raf, final long pos,
final int length, final String exception) throws IOException {
if (length < 0) {
@@ -205,7 +205,7 @@ public final class BinaryFunctions {
* @param exception The exception message if read fails.
* @param byteOrder The byte order.
* @return The 16-bit value.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static int read2Bytes(final String name, final InputStream in,
final String exception, final ByteOrder byteOrder) throws IOException {
final int byte0 = in.read();
@@ -230,7 +230,7 @@ public final class BinaryFunctions {
* @param exception The exception message if read fails.
* @param byteOrder The byte order.
* @return The 24-bit value.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static int read3Bytes(final String name, final InputStream in,
final String exception, final ByteOrder byteOrder) throws IOException {
final int byte0 = in.read();
@@ -256,7 +256,7 @@ public final class BinaryFunctions {
* @param exception The exception message if read fails.
* @param byteOrder The byte order.
* @return The 32-bit value.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static int read4Bytes(final String name, final InputStream in,
final String exception, final ByteOrder byteOrder) throws IOException {
final int byte0 = in.read();
@@ -313,7 +313,7 @@ public final class BinaryFunctions {
* @param expected The expected binary constant.
* @param exception The exception message if bytes don't match.
* @throws ImagingException if the bytes don't match or EOF is reached.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static void readAndVerifyBytes(final InputStream in, final
BinaryConstant expected, final String exception) throws ImagingException,
IOException {
readAndVerifyBytes(in, expected.rawValue(), exception);
@@ -326,7 +326,7 @@ public final class BinaryFunctions {
* @param expected The expected byte array.
* @param exception The exception message if bytes don't match.
* @throws ImagingException if the bytes don't match or EOF is reached.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static void readAndVerifyBytes(final InputStream in, final byte[]
expected, final String exception) throws ImagingException, IOException {
for (final byte element : expected) {
@@ -348,7 +348,7 @@ public final class BinaryFunctions {
* @param in The input stream.
* @param exceptionMessage The exception message if read fails.
* @return The byte read.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static byte readByte(final String name, final InputStream in, final
String exceptionMessage) throws IOException {
final int result = in.read();
@@ -364,7 +364,7 @@ public final class BinaryFunctions {
* @param in The input stream.
* @param count The number of bytes to read.
* @return The bytes read.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static byte[] readBytes(final InputStream in, final int count)
throws IOException {
return readBytes(StringUtils.EMPTY, in, count, "Unexpected EOF");
@@ -377,7 +377,7 @@ public final class BinaryFunctions {
* @param in The input stream.
* @param length The number of bytes to read.
* @return The bytes read.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static byte[] readBytes(final String name, final InputStream in,
final int length) throws IOException {
return readBytes(name, in, length, name + " could not be read.");
@@ -391,7 +391,7 @@ public final class BinaryFunctions {
* @param length The number of bytes to read.
* @param exception The exception message if read fails.
* @return The bytes read.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static byte[] readBytes(final String name, final InputStream in,
final int length, final String exception) throws IOException {
try {
@@ -423,7 +423,7 @@ public final class BinaryFunctions {
* @param quad A quad (the needle).
* @param in An input stream (the haystack).
* @return {@code true} if it found the quad, and {@code false} otherwise.
- * @throws IOException if it fails to read from the given input stream.
+ * @throws IOException Thrown if it fails to read from the given input
stream.
*/
public static boolean searchQuad(final int quad, final InputStream in)
throws IOException {
final byte[] needle = quadsToByteArray(quad);
@@ -448,7 +448,7 @@ public final class BinaryFunctions {
* @param in The input stream.
* @param skip The number of bytes to skip.
* @return The number of bytes actually skipped.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static long skipBytes(final InputStream in, final long skip) throws
IOException {
return skipBytes(in, skip, "Couldn't skip bytes");
@@ -461,7 +461,7 @@ public final class BinaryFunctions {
* @param skip The number of bytes to skip.
* @param exMessage The exception message if skip fails.
* @return The number of bytes actually skipped.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static long skipBytes(final InputStream in, final long skip, final
String exMessage) throws IOException {
try {
diff --git a/src/main/java/org/apache/commons/imaging/common/PackBits.java
b/src/main/java/org/apache/commons/imaging/common/PackBits.java
index 77757b8d..f814a091 100644
--- a/src/main/java/org/apache/commons/imaging/common/PackBits.java
+++ b/src/main/java/org/apache/commons/imaging/common/PackBits.java
@@ -32,7 +32,7 @@ public final class PackBits {
*
* @param bytes The bytes to compress.
* @return The compressed bytes.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static byte[] compress(final byte[] bytes) throws IOException {
// max length 1 extra byte for every 128
diff --git
a/src/main/java/org/apache/commons/imaging/formats/bmp/BmpImageParser.java
b/src/main/java/org/apache/commons/imaging/formats/bmp/BmpImageParser.java
index 2c48317b..616818b0 100644
--- a/src/main/java/org/apache/commons/imaging/formats/bmp/BmpImageParser.java
+++ b/src/main/java/org/apache/commons/imaging/formats/bmp/BmpImageParser.java
@@ -129,7 +129,7 @@ public class BmpImageParser extends
AbstractImageParser<BmpImagingParameters> {
* @param params The imaging parameters.
* @return The BufferedImage.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public BufferedImage getBufferedImage(final InputStream inputStream, final
BmpImagingParameters params) throws ImagingException, IOException {
final BmpImageContents ic = readImageContents(inputStream,
FormatCompliance.getDefault());
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/JpegImageParser.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/JpegImageParser.java
index 3b1c26e4..4dee3e7e 100644
--- a/src/main/java/org/apache/commons/imaging/formats/jpeg/JpegImageParser.java
+++ b/src/main/java/org/apache/commons/imaging/formats/jpeg/JpegImageParser.java
@@ -243,7 +243,7 @@ public class JpegImageParser extends
AbstractImageParser<JpegImagingParameters>
* @param params The TIFF imaging parameters.
* @return The EXIF metadata or null if not found.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public TiffImageMetadata getExifMetadata(final ByteSource byteSource,
TiffImagingParameters params) throws ImagingException, IOException {
final byte[] bytes = getExifRawData(byteSource);
@@ -265,7 +265,7 @@ public class JpegImageParser extends
AbstractImageParser<JpegImagingParameters>
* @param byteSource The byte source.
* @return The raw EXIF data or null if not found.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public byte[] getExifRawData(final ByteSource byteSource) throws
ImagingException, IOException {
final List<AbstractSegment> abstractSegments =
readSegments(byteSource, new int[] { JpegConstants.JPEG_APP1_MARKER, }, false);
@@ -697,7 +697,7 @@ public class JpegImageParser extends
AbstractImageParser<JpegImagingParameters>
* @param params The imaging parameters.
* @return The Photoshop metadata or null if not found.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public JpegPhotoshopMetadata getPhotoshopMetadata(final ByteSource
byteSource, final JpegImagingParameters params) throws ImagingException,
IOException {
final List<AbstractSegment> abstractSegments =
readSegments(byteSource, new int[] { JpegConstants.JPEG_APP13_MARKER, }, false);
@@ -733,7 +733,7 @@ public class JpegImageParser extends
AbstractImageParser<JpegImagingParameters>
* @param params Map of optional parameters, defined in
ImagingConstants.
* @return Xmp Xml as String, if present. Otherwise, returns null.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
@Override
public String getXmpXml(final ByteSource byteSource, final
XmpImagingParameters<JpegImagingParameters> params) throws ImagingException,
IOException {
@@ -785,7 +785,7 @@ public class JpegImageParser extends
AbstractImageParser<JpegImagingParameters>
* @param byteSource The byte source.
* @return true if EXIF segment is present, false otherwise.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public boolean hasExifSegment(final ByteSource byteSource) throws
ImagingException, IOException {
final boolean[] result = { false, };
@@ -830,7 +830,7 @@ public class JpegImageParser extends
AbstractImageParser<JpegImagingParameters>
* @param byteSource The byte source.
* @return true if IPTC segment is present, false otherwise.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public boolean hasIptcSegment(final ByteSource byteSource) throws
ImagingException, IOException {
final boolean[] result = { false, };
@@ -875,7 +875,7 @@ public class JpegImageParser extends
AbstractImageParser<JpegImagingParameters>
* @param byteSource The byte source.
* @return true if XMP segment is present, false otherwise.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public boolean hasXmpSegment(final ByteSource byteSource) throws
ImagingException, IOException {
final boolean[] result = { false, };
@@ -925,7 +925,7 @@ public class JpegImageParser extends
AbstractImageParser<JpegImagingParameters>
* @param returnAfterFirst whether to return after first match.
* @return The list of segments.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public List<AbstractSegment> readSegments(final ByteSource byteSource,
final int[] markers, final boolean returnAfterFirst)
throws ImagingException, IOException {
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/JpegUtils.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/JpegUtils.java
index 8392ad3f..020fdc73 100644
--- a/src/main/java/org/apache/commons/imaging/formats/jpeg/JpegUtils.java
+++ b/src/main/java/org/apache/commons/imaging/formats/jpeg/JpegUtils.java
@@ -55,7 +55,7 @@ public class JpegUtils extends BinaryFileParser {
* @param segmentData The segment data.
* @return false to exit traversal.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
boolean visitSegment(int marker, byte[] markerBytes, int
segmentLength, byte[] segmentLengthBytes, byte[] segmentData)
throws ImagingException, IOException;
@@ -165,7 +165,7 @@ public class JpegUtils extends BinaryFileParser {
*
* @param byteSource The byte source.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public void dumpJfif(final ByteSource byteSource) throws ImagingException,
IOException {
final Visitor visitor = new Visitor() {
@@ -200,7 +200,7 @@ public class JpegUtils extends BinaryFileParser {
* @param byteSource The byte source.
* @param visitor The visitor.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public void traverseJfif(final ByteSource byteSource, final Visitor
visitor) throws ImagingException, IOException {
try (InputStream is = byteSource.getInputStream()) {
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/decoder/JpegDecoder.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/decoder/JpegDecoder.java
index 41ad8eca..56cea229 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/decoder/JpegDecoder.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/decoder/JpegDecoder.java
@@ -184,7 +184,7 @@ public class JpegDecoder extends BinaryFileParser
implements JpegUtils.Visitor {
*
* @param byteSource The byte source containing the JPEG data.
* @return The decoded BufferedImage.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
* @throws ImagingException if an imaging error occurs.
*/
public BufferedImage decode(final ByteSource byteSource) throws
IOException, ImagingException {
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/iptc/IptcParser.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/iptc/IptcParser.java
index fd970290..b3a80d94 100644
--- a/src/main/java/org/apache/commons/imaging/formats/jpeg/iptc/IptcParser.java
+++ b/src/main/java/org/apache/commons/imaging/formats/jpeg/iptc/IptcParser.java
@@ -120,7 +120,7 @@ public class IptcParser extends BinaryFileParser {
* @param strict whether to use strict parsing mode.
* @return A list of IPTC blocks.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
protected List<IptcBlock> parseAllBlocks(final byte[] bytes, final boolean
strict) throws ImagingException, IOException {
final List<IptcBlock> blocks = new ArrayList<>();
@@ -353,7 +353,7 @@ public class IptcParser extends BinaryFileParser {
* @param strict whether to use strict parsing mode.
* @return The parsed Photoshop APP13 data.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public PhotoshopApp13Data parsePhotoshopSegment(final byte[] bytes, final
boolean strict) throws ImagingException, IOException {
final List<IptcRecord> records = new ArrayList<>();
@@ -405,7 +405,7 @@ public class IptcParser extends BinaryFileParser {
* @param params The imaging parameters.
* @return The parsed Photoshop APP13 data.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public PhotoshopApp13Data parsePhotoshopSegment(final byte[] bytes, final
ImagingParameters<JpegImagingParameters> params)
throws ImagingException, IOException {
@@ -420,7 +420,7 @@ public class IptcParser extends BinaryFileParser {
* @param elements The list of IPTC records to write.
* @return The byte array containing the IPTC block.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public byte[] writeIptcBlock(final List<IptcRecord> elements) throws
ImagingException, IOException {
return writeIptcBlock(elements, false);
@@ -433,7 +433,7 @@ public class IptcParser extends BinaryFileParser {
* @param forceUtf8Encoding whether to force UTF-8 encoding.
* @return The byte array containing the IPTC block.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public byte[] writeIptcBlock(List<IptcRecord> elements, final boolean
forceUtf8Encoding) throws ImagingException, IOException {
Charset charset;
@@ -511,7 +511,7 @@ public class IptcParser extends BinaryFileParser {
*
* @param data The Photoshop APP13 data to write.
* @return The byte array containing the APP13 segment.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
* @throws ImagingException if an imaging error occurs.
*/
public byte[] writePhotoshopApp13Segment(final PhotoshopApp13Data data)
throws IOException, ImagingException {
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/AbstractGenericSegment.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/AbstractGenericSegment.java
index 3ac4a5e5..51539b70 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/AbstractGenericSegment.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/AbstractGenericSegment.java
@@ -47,7 +47,7 @@ public abstract class AbstractGenericSegment extends
AbstractSegment {
* @param marker The segment marker.
* @param markerLength The length of the marker data.
* @param is The input stream to read from.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public AbstractGenericSegment(final int marker, final int markerLength,
final InputStream is) throws IOException {
super(marker, markerLength);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App13Segment.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App13Segment.java
index 8c9b693c..0522ede0 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App13Segment.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App13Segment.java
@@ -36,7 +36,7 @@ public class App13Segment extends AppnSegment {
*
* @param marker The segment marker.
* @param segmentData The segment data.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public App13Segment(final int marker, final byte[] segmentData) throws
IOException {
this(marker, segmentData.length, new
ByteArrayInputStream(segmentData));
@@ -48,7 +48,7 @@ public class App13Segment extends AppnSegment {
* @param marker The segment marker.
* @param markerLength The marker length.
* @param is The input stream to read from.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public App13Segment(final int marker, final int markerLength, final
InputStream is) throws IOException {
super(marker, markerLength, is);
@@ -83,7 +83,7 @@ public class App13Segment extends AppnSegment {
* @param params The imaging parameters.
* @return The parsed Photoshop APP13 data, or {@code null} if not a
Photoshop segment.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public PhotoshopApp13Data parsePhotoshopSegment(final
ImagingParameters<JpegImagingParameters> params) throws ImagingException,
IOException {
/*
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App14Segment.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App14Segment.java
index 3b94b61e..9c10f9e4 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App14Segment.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App14Segment.java
@@ -49,7 +49,7 @@ public class App14Segment extends AppnSegment {
*
* @param marker The segment marker.
* @param segmentData The segment data.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public App14Segment(final int marker, final byte[] segmentData) throws
IOException {
this(marker, segmentData.length, new
ByteArrayInputStream(segmentData));
@@ -61,7 +61,7 @@ public class App14Segment extends AppnSegment {
* @param marker The segment marker.
* @param markerLength The marker length.
* @param is The input stream to read from.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public App14Segment(final int marker, final int markerLength, final
InputStream is) throws IOException {
super(marker, markerLength, is);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App2Segment.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App2Segment.java
index 4763e683..42d5f058 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App2Segment.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/App2Segment.java
@@ -45,7 +45,7 @@ public final class App2Segment extends AppnSegment implements
Comparable<App2Seg
* @param marker The segment marker.
* @param segmentData The segment data.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public App2Segment(final int marker, final byte[] segmentData) throws
ImagingException, IOException {
this(marker, segmentData.length, new
ByteArrayInputStream(segmentData));
@@ -58,7 +58,7 @@ public final class App2Segment extends AppnSegment implements
Comparable<App2Seg
* @param markerLength The marker length.
* @param is2 The input stream to read from.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public App2Segment(final int marker, int markerLength, final InputStream
is2) throws ImagingException, IOException {
super(marker, markerLength, is2);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/AppnSegment.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/AppnSegment.java
index 2009091f..66ac8ace 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/AppnSegment.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/AppnSegment.java
@@ -32,7 +32,7 @@ public class AppnSegment extends AbstractGenericSegment {
* @param marker The segment marker.
* @param markerLength The marker length.
* @param is The input stream to read from.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public AppnSegment(final int marker, final int markerLength, final
InputStream is) throws IOException {
super(marker, markerLength, is);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/ComSegment.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/ComSegment.java
index 8e006f5f..51daa508 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/ComSegment.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/ComSegment.java
@@ -41,7 +41,7 @@ public class ComSegment extends AbstractGenericSegment {
* @param marker The segment marker.
* @param markerLength The marker length.
* @param is The input stream to read from.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public ComSegment(final int marker, final int markerLength, final
InputStream is) throws IOException {
super(marker, markerLength, is);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/DhtSegment.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/DhtSegment.java
index 8eb91ff0..a35562b5 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/DhtSegment.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/DhtSegment.java
@@ -177,7 +177,7 @@ public final class DhtSegment extends AbstractSegment {
*
* @param marker The segment marker.
* @param segmentData The segment data.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public DhtSegment(final int marker, final byte[] segmentData) throws
IOException {
this(marker, segmentData.length, new
ByteArrayInputStream(segmentData));
@@ -189,7 +189,7 @@ public final class DhtSegment extends AbstractSegment {
* @param marker The segment marker.
* @param length The segment length.
* @param is The input stream to read from.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public DhtSegment(final int marker, int length, final InputStream is)
throws IOException {
super(marker, length);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/DqtSegment.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/DqtSegment.java
index b33ae20a..413d6884 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/DqtSegment.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/DqtSegment.java
@@ -76,7 +76,7 @@ public final class DqtSegment extends AbstractSegment {
* @param marker The segment marker.
* @param segmentData The segment data.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public DqtSegment(final int marker, final byte[] segmentData) throws
ImagingException, IOException {
this(marker, segmentData.length, new
ByteArrayInputStream(segmentData));
@@ -89,7 +89,7 @@ public final class DqtSegment extends AbstractSegment {
* @param length The segment length.
* @param is The input stream to read from.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public DqtSegment(final int marker, int length, final InputStream is)
throws ImagingException, IOException {
super(marker, length);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/SofnSegment.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/SofnSegment.java
index c94c7b9c..dcd6926a 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/SofnSegment.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/SofnSegment.java
@@ -91,7 +91,7 @@ public final class SofnSegment extends AbstractSegment {
*
* @param marker The marker.
* @param segmentData The segment data.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
* @throws ImagingException if an imaging error occurs.
*/
public SofnSegment(final int marker, final byte[] segmentData) throws
IOException, ImagingException {
@@ -104,7 +104,7 @@ public final class SofnSegment extends AbstractSegment {
* @param marker The marker.
* @param markerLength The marker length.
* @param is The input stream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
* @throws ImagingException if an imaging error occurs.
*/
public SofnSegment(final int marker, final int markerLength, final
InputStream is) throws IOException, ImagingException {
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/SosSegment.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/SosSegment.java
index 5d3b9d7f..c605217a 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/SosSegment.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/SosSegment.java
@@ -86,7 +86,7 @@ public final class SosSegment extends AbstractSegment {
*
* @param marker The marker.
* @param segmentData The segment data.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public SosSegment(final int marker, final byte[] segmentData) throws
IOException {
this(marker, segmentData.length, new
ByteArrayInputStream(segmentData));
@@ -98,7 +98,7 @@ public final class SosSegment extends AbstractSegment {
* @param marker The marker.
* @param markerLength The marker length.
* @param is The input stream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public SosSegment(final int marker, final int markerLength, final
InputStream is) throws IOException {
super(marker, markerLength);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/UnknownSegment.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/UnknownSegment.java
index 53892f6c..cd48da29 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/UnknownSegment.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/segments/UnknownSegment.java
@@ -40,7 +40,7 @@ public class UnknownSegment extends AbstractGenericSegment {
* @param marker The marker.
* @param markerLength The marker length.
* @param is The input stream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public UnknownSegment(final int marker, final int markerLength, final
InputStream is) throws IOException {
super(marker, markerLength, is);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/jpeg/xmp/JpegRewriter.java
b/src/main/java/org/apache/commons/imaging/formats/jpeg/xmp/JpegRewriter.java
index 287d5e5d..e7cdb418 100644
---
a/src/main/java/org/apache/commons/imaging/formats/jpeg/xmp/JpegRewriter.java
+++
b/src/main/java/org/apache/commons/imaging/formats/jpeg/xmp/JpegRewriter.java
@@ -57,7 +57,7 @@ public class JpegRewriter extends BinaryFileParser {
* Writes the piece to output stream.
*
* @param os The output stream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
protected abstract void write(OutputStream os) throws IOException;
}
@@ -270,7 +270,7 @@ public class JpegRewriter extends BinaryFileParser {
* @param byteSource The byte source.
* @return The JFIF pieces.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
protected JFIFPieces analyzeJfif(final ByteSource byteSource) throws
ImagingException, IOException {
final List<JFIFPiece> pieces = new ArrayList<>();
@@ -479,7 +479,7 @@ public class JpegRewriter extends BinaryFileParser {
*
* @param outputStream The output stream.
* @param segments The segments to write.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
protected void writeSegments(final OutputStream outputStream, final List<?
extends JFIFPiece> segments) throws IOException {
try (DataOutputStream os = new DataOutputStream(outputStream)) {
diff --git
a/src/main/java/org/apache/commons/imaging/formats/png/PngImageParser.java
b/src/main/java/org/apache/commons/imaging/formats/png/PngImageParser.java
index 6086963a..ac5995cc 100644
--- a/src/main/java/org/apache/commons/imaging/formats/png/PngImageParser.java
+++ b/src/main/java/org/apache/commons/imaging/formats/png/PngImageParser.java
@@ -653,7 +653,7 @@ public class PngImageParser extends
AbstractImageParser<PngImagingParameters> im
* @param chunkType The chunk type to check.
* @return true if chunk type exists, false otherwise.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public boolean hasChunkType(final ByteSource byteSource, final ChunkType
chunkType) throws ImagingException, IOException {
try (InputStream is = byteSource.getInputStream()) {
diff --git
a/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkGama.java
b/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkGama.java
index d3d9675b..873a9344 100644
---
a/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkGama.java
+++
b/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkGama.java
@@ -35,7 +35,7 @@ public final class PngChunkGama extends PngChunk {
* @param chunkType The chunk type.
* @param crc The CRC.
* @param bytes The chunk bytes.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public PngChunkGama(final int length, final int chunkType, final int crc,
final byte[] bytes) throws IOException {
super(length, chunkType, crc, bytes);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkIhdr.java
b/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkIhdr.java
index 21b5d661..04b7ec42 100644
---
a/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkIhdr.java
+++
b/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkIhdr.java
@@ -47,7 +47,7 @@ public final class PngChunkIhdr extends PngChunk {
* @param crc The CRC.
* @param bytes The chunk bytes.
* @throws ImagingException if the chunk is corrupt.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public PngChunkIhdr(final int length, final int chunkType, final int crc,
final byte[] bytes) throws ImagingException, IOException {
super(length, chunkType, crc, bytes);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkPhys.java
b/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkPhys.java
index 62b190c2..57a8f3e1 100644
---
a/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkPhys.java
+++
b/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkPhys.java
@@ -38,7 +38,7 @@ public final class PngChunkPhys extends PngChunk {
* @param chunkType The chunk type.
* @param crc The CRC.
* @param bytes The chunk bytes.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public PngChunkPhys(final int length, final int chunkType, final int crc,
final byte[] bytes) throws IOException {
super(length, chunkType, crc, bytes);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkPlte.java
b/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkPlte.java
index 859f78e0..7b1b9c84 100644
---
a/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkPlte.java
+++
b/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkPlte.java
@@ -40,7 +40,7 @@ public final class PngChunkPlte extends PngChunk {
* @param crc The CRC.
* @param bytes The chunk bytes.
* @throws ImagingException if the chunk is corrupt.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public PngChunkPlte(final int length, final int chunkType, final int crc,
final byte[] bytes) throws ImagingException, IOException {
super(length, chunkType, crc, bytes);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkZtxt.java
b/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkZtxt.java
index 159b56d5..494a3253 100644
---
a/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkZtxt.java
+++
b/src/main/java/org/apache/commons/imaging/formats/png/chunks/PngChunkZtxt.java
@@ -44,7 +44,7 @@ public final class PngChunkZtxt extends AbstractPngTextChunk {
* @param crc The CRC.
* @param bytes The chunk bytes.
* @throws ImagingException if the chunk is corrupt.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public PngChunkZtxt(final int length, final int chunkType, final int crc,
final byte[] bytes) throws ImagingException, IOException {
super(length, chunkType, crc, bytes);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/png/scanlinefilters/ScanlineFilter.java
b/src/main/java/org/apache/commons/imaging/formats/png/scanlinefilters/ScanlineFilter.java
index 1840974e..101c1ec6 100644
---
a/src/main/java/org/apache/commons/imaging/formats/png/scanlinefilters/ScanlineFilter.java
+++
b/src/main/java/org/apache/commons/imaging/formats/png/scanlinefilters/ScanlineFilter.java
@@ -32,7 +32,7 @@ public interface ScanlineFilter {
* @param dst The destination bytes.
* @param up The previous scanline bytes.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
void unfilter(byte[] src, byte[] dst, byte[] up) throws ImagingException,
IOException;
diff --git
a/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/AbstractTransparencyFilter.java
b/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/AbstractTransparencyFilter.java
index 9e8b8870..4a1ddf6c 100644
---
a/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/AbstractTransparencyFilter.java
+++
b/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/AbstractTransparencyFilter.java
@@ -44,7 +44,7 @@ public abstract class AbstractTransparencyFilter extends
BinaryFileParser {
* @param index The pixel index.
* @return The filtered RGB value.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public abstract int filter(int rgb, int index) throws ImagingException,
IOException;
diff --git
a/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/TransparencyFilterGrayscale.java
b/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/TransparencyFilterGrayscale.java
index 9afe784b..18a7d9b3 100644
---
a/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/TransparencyFilterGrayscale.java
+++
b/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/TransparencyFilterGrayscale.java
@@ -33,7 +33,7 @@ public final class TransparencyFilterGrayscale extends
AbstractTransparencyFilte
* Constructs a new transparency filter for grayscale images.
*
* @param bytes The transparency chunk data.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public TransparencyFilterGrayscale(final byte[] bytes) throws IOException {
super(bytes);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/TransparencyFilterTrueColor.java
b/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/TransparencyFilterTrueColor.java
index e99ad14e..024018a3 100644
---
a/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/TransparencyFilterTrueColor.java
+++
b/src/main/java/org/apache/commons/imaging/formats/png/transparencyfilters/TransparencyFilterTrueColor.java
@@ -33,7 +33,7 @@ public final class TransparencyFilterTrueColor extends
AbstractTransparencyFilte
* Constructs a new transparency filter for true color images.
*
* @param bytes The transparency chunk data.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public TransparencyFilterTrueColor(final byte[] bytes) throws IOException {
super(bytes);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/psd/datareaders/DataReader.java
b/src/main/java/org/apache/commons/imaging/formats/psd/datareaders/DataReader.java
index 757f3714..fd88b5bb 100644
---
a/src/main/java/org/apache/commons/imaging/formats/psd/datareaders/DataReader.java
+++
b/src/main/java/org/apache/commons/imaging/formats/psd/datareaders/DataReader.java
@@ -37,7 +37,7 @@ public interface DataReader {
* @param imageContents The PSD image contents.
* @param bfp The binary file parser.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
void readData(InputStream is, BufferedImage bi, PsdImageContents
imageContents, BinaryFileParser bfp) throws ImagingException, IOException;
diff --git
a/src/main/java/org/apache/commons/imaging/formats/tiff/AbstractTiffImageData.java
b/src/main/java/org/apache/commons/imaging/formats/tiff/AbstractTiffImageData.java
index e0346c8a..57235041 100644
---
a/src/main/java/org/apache/commons/imaging/formats/tiff/AbstractTiffImageData.java
+++
b/src/main/java/org/apache/commons/imaging/formats/tiff/AbstractTiffImageData.java
@@ -217,7 +217,7 @@ public abstract class AbstractTiffImageData {
* @param planarConfiguration The planar configuration.
* @param byteOrder The byte order.
* @return The data reader.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
* @throws ImagingException if the image format is invalid.
*/
public abstract AbstractImageDataReader getDataReader(TiffDirectory
directory, AbstractPhotometricInterpreter photometricInterpreter, int
bitsPerPixel,
diff --git
a/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImageMetadata.java
b/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImageMetadata.java
index f72740c1..06aa1cd1 100644
---
a/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImageMetadata.java
+++
b/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImageMetadata.java
@@ -181,7 +181,7 @@ public class TiffImageMetadata extends GenericImageMetadata
{
*
* @return The thumbnail image.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public BufferedImage getThumbnail() throws ImagingException,
IOException {
return directory.getTiffImage(byteOrder);
diff --git
a/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImageParser.java
b/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImageParser.java
index f24fc6c7..e3359d3a 100644
--- a/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImageParser.java
+++ b/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImageParser.java
@@ -95,7 +95,7 @@ public class TiffImageParser extends
AbstractImageParser<TiffImagingParameters>
* @param params The imaging parameters.
* @return The list of raw image data.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public List<byte[]> collectRawImageData(final ByteSource byteSource, final
TiffImagingParameters params) throws ImagingException, IOException {
final FormatCompliance formatCompliance =
FormatCompliance.getDefault();
@@ -253,7 +253,7 @@ public class TiffImageParser extends
AbstractImageParser<TiffImagingParameters>
* @param params The imaging parameters.
* @return The buffered image.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
protected BufferedImage getBufferedImage(final TiffDirectory directory,
final ByteOrder byteOrder, final TiffImagingParameters params)
throws ImagingException, IOException {
diff --git
a/src/main/java/org/apache/commons/imaging/formats/tiff/TiffReader.java
b/src/main/java/org/apache/commons/imaging/formats/tiff/TiffReader.java
index b81de2fc..8edd59df 100644
--- a/src/main/java/org/apache/commons/imaging/formats/tiff/TiffReader.java
+++ b/src/main/java/org/apache/commons/imaging/formats/tiff/TiffReader.java
@@ -254,7 +254,7 @@ public class TiffReader extends BinaryFileParser {
* @param formatCompliance The format compliance.
* @param listener The listener for callbacks.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public void read(final ByteSource byteSource, final FormatCompliance
formatCompliance, final Listener listener) throws ImagingException, IOException
{
readDirectories(byteSource, formatCompliance, listener);
@@ -268,7 +268,7 @@ public class TiffReader extends BinaryFileParser {
* @param formatCompliance The format compliance.
* @return The TIFF contents.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public TiffContents readContents(final ByteSource byteSource, final
TiffImagingParameters params, final FormatCompliance formatCompliance)
throws ImagingException, IOException {
@@ -286,7 +286,7 @@ public class TiffReader extends BinaryFileParser {
* @param formatCompliance The format compliance.
* @return The TIFF contents.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public TiffContents readDirectories(final ByteSource byteSource, final
boolean readImageData, final FormatCompliance formatCompliance)
throws ImagingException, IOException {
@@ -495,7 +495,7 @@ public class TiffReader extends BinaryFileParser {
* @param formatCompliance The format compliance.
* @return The TIFF contents containing only the first directory.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public TiffContents readFirstDirectory(final ByteSource byteSource, final
boolean readImageData, final FormatCompliance formatCompliance)
throws ImagingException, IOException {
diff --git
a/src/main/java/org/apache/commons/imaging/formats/tiff/datareaders/AbstractImageDataReader.java
b/src/main/java/org/apache/commons/imaging/formats/tiff/datareaders/AbstractImageDataReader.java
index 21cf7d62..37c7adb2 100644
---
a/src/main/java/org/apache/commons/imaging/formats/tiff/datareaders/AbstractImageDataReader.java
+++
b/src/main/java/org/apache/commons/imaging/formats/tiff/datareaders/AbstractImageDataReader.java
@@ -238,7 +238,7 @@ public abstract class AbstractImageDataReader {
* @param tileHeight The tile height.
* @return The decompressed data.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
protected byte[] decompress(final byte[] compressedInput, final int
compression, final int expectedSize, final int tileWidth, final int tileHeight)
throws ImagingException, IOException {
diff --git
a/src/main/java/org/apache/commons/imaging/formats/tiff/photometricinterpreters/AbstractPhotometricInterpreter.java
b/src/main/java/org/apache/commons/imaging/formats/tiff/photometricinterpreters/AbstractPhotometricInterpreter.java
index 7348f8c7..c62401fc 100644
---
a/src/main/java/org/apache/commons/imaging/formats/tiff/photometricinterpreters/AbstractPhotometricInterpreter.java
+++
b/src/main/java/org/apache/commons/imaging/formats/tiff/photometricinterpreters/AbstractPhotometricInterpreter.java
@@ -79,7 +79,7 @@ public abstract class AbstractPhotometricInterpreter {
* @param x The x coordinate.
* @param y The y coordinate.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public abstract void interpretPixel(ImageBuilder imageBuilder, int[]
samples, int x, int y) throws ImagingException, IOException;
}
diff --git
a/src/main/java/org/apache/commons/imaging/formats/tiff/write/AbstractTiffImageWriter.java
b/src/main/java/org/apache/commons/imaging/formats/tiff/write/AbstractTiffImageWriter.java
index 857bfc9b..45612014 100644
---
a/src/main/java/org/apache/commons/imaging/formats/tiff/write/AbstractTiffImageWriter.java
+++
b/src/main/java/org/apache/commons/imaging/formats/tiff/write/AbstractTiffImageWriter.java
@@ -385,7 +385,7 @@ public abstract class AbstractTiffImageWriter {
*
* @param os The output stream.
* @param outputSet The TIFF output set to write.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
* @throws ImagingException if the image format is invalid.
*/
public abstract void write(OutputStream os, TiffOutputSet outputSet)
throws IOException, ImagingException;
@@ -397,7 +397,7 @@ public abstract class AbstractTiffImageWriter {
* @param os The output stream.
* @param params The imaging parameters.
* @throws ImagingException if the image format is invalid.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public void writeImage(final BufferedImage src, final OutputStream os,
final TiffImagingParameters params) throws ImagingException, IOException {
final TiffOutputSet userExif = params.getOutputSet();
@@ -634,7 +634,7 @@ public abstract class AbstractTiffImageWriter {
* Writes the TIFF image file header with the default header size.
*
* @param bos The binary output stream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
protected void writeImageFileHeader(final AbstractBinaryOutputStream bos)
throws IOException {
writeImageFileHeader(bos, TiffConstants.HEADER_SIZE);
@@ -645,7 +645,7 @@ public abstract class AbstractTiffImageWriter {
*
* @param bos The binary output stream.
* @param offsetToFirstIFD The offset to the first Image File Directory.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
protected void writeImageFileHeader(final AbstractBinaryOutputStream bos,
final long offsetToFirstIFD) throws IOException {
if (byteOrder == ByteOrder.LITTLE_ENDIAN) {
diff --git
a/src/main/java/org/apache/commons/imaging/formats/tiff/write/AbstractTiffOutputItem.java
b/src/main/java/org/apache/commons/imaging/formats/tiff/write/AbstractTiffOutputItem.java
index 1852d6f5..f75cc84b 100644
---
a/src/main/java/org/apache/commons/imaging/formats/tiff/write/AbstractTiffOutputItem.java
+++
b/src/main/java/org/apache/commons/imaging/formats/tiff/write/AbstractTiffOutputItem.java
@@ -100,7 +100,7 @@ abstract class AbstractTiffOutputItem {
* Writes this item to the output stream.
*
* @param bos The output stream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
* @throws ImagingException if an imaging error occurs.
*/
public abstract void writeItem(AbstractBinaryOutputStream bos) throws
IOException, ImagingException;
diff --git
a/src/main/java/org/apache/commons/imaging/formats/tiff/write/TiffOutputField.java
b/src/main/java/org/apache/commons/imaging/formats/tiff/write/TiffOutputField.java
index 1f1a919c..19108b1d 100644
---
a/src/main/java/org/apache/commons/imaging/formats/tiff/write/TiffOutputField.java
+++
b/src/main/java/org/apache/commons/imaging/formats/tiff/write/TiffOutputField.java
@@ -213,7 +213,7 @@ public class TiffOutputField {
* Writes this field to the output stream.
*
* @param bos The output stream.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
* @throws ImagingException if an imaging error occurs.
*/
protected void writeField(final AbstractBinaryOutputStream bos) throws
IOException, ImagingException {
diff --git a/src/main/java/org/apache/commons/imaging/icc/IccProfileInfo.java
b/src/main/java/org/apache/commons/imaging/icc/IccProfileInfo.java
index bb7b3539..86eac8d8 100644
--- a/src/main/java/org/apache/commons/imaging/icc/IccProfileInfo.java
+++ b/src/main/java/org/apache/commons/imaging/icc/IccProfileInfo.java
@@ -182,7 +182,7 @@ public class IccProfileInfo {
* @param prefix The prefix to use for output lines.
* @return A string representation of the profile information.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public String toString(final String prefix) throws ImagingException,
IOException {
final StringWriter sw = new StringWriter();
diff --git a/src/main/java/org/apache/commons/imaging/icc/IccProfileParser.java
b/src/main/java/org/apache/commons/imaging/icc/IccProfileParser.java
index 58901be8..96460890 100644
--- a/src/main/java/org/apache/commons/imaging/icc/IccProfileParser.java
+++ b/src/main/java/org/apache/commons/imaging/icc/IccProfileParser.java
@@ -52,7 +52,7 @@ public class IccProfileParser extends BinaryFileParser {
*
* @param bytes The bytes.
* @return The ICC profile info or null if bytes is null.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public IccProfileInfo getIccProfileInfo(final byte[] bytes) throws
IOException {
if (bytes == null) {
@@ -66,7 +66,7 @@ public class IccProfileParser extends BinaryFileParser {
*
* @param byteSource The byte source.
* @return The ICC profile info.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public IccProfileInfo getIccProfileInfo(final ByteSource byteSource)
throws IOException {
// TODO Throw instead of logging?
@@ -90,7 +90,7 @@ public class IccProfileParser extends BinaryFileParser {
*
* @param file The file.
* @return The ICC profile info or null if file is null.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public IccProfileInfo getIccProfileInfo(final File file) throws
IOException {
if (file == null) {
@@ -105,7 +105,7 @@ public class IccProfileParser extends BinaryFileParser {
*
* @param iccProfile The ICC profile.
* @return The ICC profile info or null if iccProfile is null.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public IccProfileInfo getIccProfileInfo(final ICC_Profile iccProfile)
throws IOException {
if (iccProfile == null) {
@@ -130,7 +130,7 @@ public class IccProfileParser extends BinaryFileParser {
*
* @param bytes The bytes.
* @return true if sRGB, false otherwise.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public boolean isSrgb(final byte[] bytes) throws IOException {
return isSrgb(ByteSource.array(bytes));
@@ -141,7 +141,7 @@ public class IccProfileParser extends BinaryFileParser {
*
* @param byteSource The byte source.
* @return true if sRGB, false otherwise.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public boolean isSrgb(final ByteSource byteSource) throws IOException {
// setDebug(true);
@@ -182,7 +182,7 @@ public class IccProfileParser extends BinaryFileParser {
*
* @param file The file.
* @return true if sRGB, false otherwise.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public boolean isSrgb(final File file) throws IOException {
return isSrgb(ByteSource.file(file));
@@ -193,7 +193,7 @@ public class IccProfileParser extends BinaryFileParser {
*
* @param iccProfile The ICC profile.
* @return true if sRGB, false otherwise.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public boolean isSrgb(final ICC_Profile iccProfile) throws IOException {
return isSrgb(ByteSource.array(iccProfile.getData()));
diff --git a/src/main/java/org/apache/commons/imaging/icc/IccTag.java
b/src/main/java/org/apache/commons/imaging/icc/IccTag.java
index 51fc3899..5a0ee18a 100644
--- a/src/main/java/org/apache/commons/imaging/icc/IccTag.java
+++ b/src/main/java/org/apache/commons/imaging/icc/IccTag.java
@@ -73,7 +73,7 @@ public class IccTag {
* @param pw The PrintWriter to write to.
* @param prefix The prefix to use for output lines.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public void dump(final PrintWriter pw, final String prefix) throws
ImagingException, IOException {
pw.println(prefix + "tag signature: " + Integer.toHexString(signature)
+ " (" + new String(new byte[] { (byte) (0xff & signature >> 24),
@@ -108,7 +108,7 @@ public class IccTag {
*
* @param prefix The prefix to use for output lines.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public void dump(final String prefix) throws ImagingException, IOException
{
try (StringWriter sw = new StringWriter();
@@ -134,7 +134,7 @@ public class IccTag {
* Sets the tag data.
*
* @param bytes The tag data bytes.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public void setData(final byte[] bytes) throws IOException {
data = bytes;
diff --git a/src/main/java/org/apache/commons/imaging/icc/IccTagDataType.java
b/src/main/java/org/apache/commons/imaging/icc/IccTagDataType.java
index 9b1cb1a2..194ae36c 100644
--- a/src/main/java/org/apache/commons/imaging/icc/IccTagDataType.java
+++ b/src/main/java/org/apache/commons/imaging/icc/IccTagDataType.java
@@ -28,7 +28,7 @@ interface IccTagDataType {
* @param prefix The prefix for output.
* @param bytes The data bytes.
* @throws ImagingException if an imaging error occurs.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
void dump(String prefix, byte[] bytes) throws ImagingException,
IOException;
diff --git
a/src/main/java/org/apache/commons/imaging/internal/ImageParserFactory.java
b/src/main/java/org/apache/commons/imaging/internal/ImageParserFactory.java
index 170d6d3c..5e7c39b5 100644
--- a/src/main/java/org/apache/commons/imaging/internal/ImageParserFactory.java
+++ b/src/main/java/org/apache/commons/imaging/internal/ImageParserFactory.java
@@ -41,7 +41,7 @@ public final class ImageParserFactory {
* @param <T> The imaging parameters type.
* @param byteSource The byte source.
* @return The image parser.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public static <T extends ImagingParameters<T>> AbstractImageParser<T>
getImageParser(final ByteSource byteSource) throws IOException {
// TODO: circular dependency between Imaging and internal Util class
below.
diff --git
a/src/main/java/org/apache/commons/imaging/mylzw/BitsToByteInputStream.java
b/src/main/java/org/apache/commons/imaging/mylzw/BitsToByteInputStream.java
index d2f76818..31a807a3 100644
--- a/src/main/java/org/apache/commons/imaging/mylzw/BitsToByteInputStream.java
+++ b/src/main/java/org/apache/commons/imaging/mylzw/BitsToByteInputStream.java
@@ -48,7 +48,7 @@ public class BitsToByteInputStream extends FilterInputStream {
*
* @param bitCount The number of bits to read.
* @return The adjusted value.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public int readBits(final int bitCount) throws IOException {
int i = ((MyBitInputStream) in).readBits(bitCount);
@@ -67,7 +67,7 @@ public class BitsToByteInputStream extends FilterInputStream {
* @param sampleBits The number of bits per sample.
* @param length The number of samples to read.
* @return The array of values.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public int[] readBitsArray(final int sampleBits, final int length) throws
IOException {
final int[] result = Allocator.intArray(length);
diff --git
a/src/main/java/org/apache/commons/imaging/mylzw/MyBitInputStream.java
b/src/main/java/org/apache/commons/imaging/mylzw/MyBitInputStream.java
index 60bcdcbe..22908b75 100644
--- a/src/main/java/org/apache/commons/imaging/mylzw/MyBitInputStream.java
+++ b/src/main/java/org/apache/commons/imaging/mylzw/MyBitInputStream.java
@@ -71,7 +71,7 @@ public class MyBitInputStream extends FilterInputStream {
*
* @param sampleBits number of bits to read.
* @return The bits as an integer.
- * @throws IOException if I/O error occurs.
+ * @throws IOException Thrown if I/O error occurs.
*/
public int readBits(final int sampleBits) throws IOException {
while (bitsInCache < sampleBits) {
diff --git
a/src/main/java/org/apache/commons/imaging/mylzw/MyLzwCompressor.java
b/src/main/java/org/apache/commons/imaging/mylzw/MyLzwCompressor.java
index 487b661b..426e8452 100644
--- a/src/main/java/org/apache/commons/imaging/mylzw/MyLzwCompressor.java
+++ b/src/main/java/org/apache/commons/imaging/mylzw/MyLzwCompressor.java
@@ -231,7 +231,7 @@ public class MyLzwCompressor {
*
* @param bytes The bytes to compress.
* @return The compressed bytes.
- * @throws IOException if an I/O error occurs.
+ * @throws IOException Thrown if an I/O error occurs.
*/
public byte[] compress(final byte[] bytes) throws IOException {
try (ByteArrayOutputStream baos = new
ByteArrayOutputStream(Allocator.checkByteArray(bytes.length));
diff --git
a/src/main/java/org/apache/commons/imaging/mylzw/MyLzwDecompressor.java
b/src/main/java/org/apache/commons/imaging/mylzw/MyLzwDecompressor.java
index 224b82a3..65f6d2c7 100644
--- a/src/main/java/org/apache/commons/imaging/mylzw/MyLzwDecompressor.java
+++ b/src/main/java/org/apache/commons/imaging/mylzw/MyLzwDecompressor.java
@@ -142,7 +142,7 @@ public final class MyLzwDecompressor {
* @param is input stream.
* @param expectedLength expected length.
* @return decompressed bytes.
- * @throws IOException if I/O error occurs.
+ * @throws IOException Thrown if I/O error occurs.
*/
public byte[] decompress(final InputStream is, final int expectedLength)
throws IOException {
int code;
diff --git
a/src/test/java/org/apache/commons/imaging/formats/gif/GifReadTest.java
b/src/test/java/org/apache/commons/imaging/formats/gif/GifReadTest.java
index abdf8ac0..d8b3cb7e 100644
--- a/src/test/java/org/apache/commons/imaging/formats/gif/GifReadTest.java
+++ b/src/test/java/org/apache/commons/imaging/formats/gif/GifReadTest.java
@@ -160,7 +160,7 @@ class GifReadTest extends AbstractGifTest {
* See Google OSS Fuzz issue 33464
* </p>
*
- * @throws IOException if it fails to read the test image
+ * @throws IOException Thrown if it fails to read the test image
*/
@Test
void testUncaughtExceptionOssFuzz33464() throws IOException {
@@ -176,7 +176,7 @@ class GifReadTest extends AbstractGifTest {
* See Google OSS Fuzz issue 33501
* </p>
*
- * @throws IOException if it fails to read the test image
+ * @throws IOException Thrown if it fails to read the test image
*/
@Test
void testUncaughtExceptionOssFuzz33501() throws IOException {
@@ -192,7 +192,7 @@ class GifReadTest extends AbstractGifTest {
* See Google OSS Fuzz issue 34185
* </p>
*
- * @throws IOException if it fails to read the test image
+ * @throws IOException Thrown if it fails to read the test image
*/
@Test
void testUncaughtExceptionOssFuzz34185() throws IOException {
diff --git
a/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/ExifRewriterRoundtripTest.java
b/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/ExifRewriterRoundtripTest.java
index b308e546..aa483fcf 100644
---
a/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/ExifRewriterRoundtripTest.java
+++
b/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/ExifRewriterRoundtripTest.java
@@ -54,7 +54,7 @@ class ExifRewriterRoundtripTest extends AbstractExifTest {
/**
* Test data.
* @return test data.
- * @throws Exception if it fails to read the images with EXIF.
+ * @throws Exception Thrown if it fails to read the images with EXIF.
*/
public static Stream<File> data() throws Exception {
return getImagesWithExifData().stream();
@@ -208,7 +208,7 @@ class ExifRewriterRoundtripTest extends AbstractExifTest {
* data from a duplicated file.
*
* @param sourceFile The input file.
- * @throws Exception if it fails to read the test image or create the
duplicated file.
+ * @throws Exception Thrown if it fails to read the test image or create
the duplicated file.
*/
@ParameterizedTest
@MethodSource("data")
diff --git
a/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/GpsTest.java
b/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/GpsTest.java
index ad8c4fef..be4957c2 100644
--- a/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/GpsTest.java
+++ b/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/GpsTest.java
@@ -71,7 +71,7 @@ class GpsTest extends AbstractExifTest {
}
/**
- * @throws Exception if it cannot open the images.
+ * @throws Exception Thrown if it cannot open the images.
*/
@Test
void testReadMetadata() throws Exception {
diff --git
a/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/WriteExifMetadataExampleTest.java
b/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/WriteExifMetadataExampleTest.java
index 6a161146..510f5e88 100644
---
a/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/WriteExifMetadataExampleTest.java
+++
b/src/test/java/org/apache/commons/imaging/formats/jpeg/exif/WriteExifMetadataExampleTest.java
@@ -42,7 +42,7 @@ class WriteExifMetadataExampleTest extends AbstractExifTest {
/**
* Test that there are no odd offsets in the generated TIFF images.
*
- * @throws Exception if the test failed for a unexpected reason
+ * @throws Exception Thrown if the test failed for a unexpected reason
*/
@ParameterizedTest
@MethodSource("data")
diff --git
a/src/test/java/org/apache/commons/imaging/formats/png/PngReadTest.java
b/src/test/java/org/apache/commons/imaging/formats/png/PngReadTest.java
index fc36f8af..95ad9813 100644
--- a/src/test/java/org/apache/commons/imaging/formats/png/PngReadTest.java
+++ b/src/test/java/org/apache/commons/imaging/formats/png/PngReadTest.java
@@ -75,7 +75,7 @@ class PngReadTest extends AbstractPngTest {
/**
* Test reading EXIF from the 'eXIf' chunk in PNG file.
*
- * @throws IOException if it fails to read the test image
+ * @throws IOException Thrown if it fails to read the test image
* @throws ImagingException if it fails to read the test image
*/
@Test
@@ -128,7 +128,7 @@ class PngReadTest extends AbstractPngTest {
* See Google OSS Fuzz issue 33691
* </p>
*
- * @throws IOException if it fails to read the test image
+ * @throws IOException Thrown if it fails to read the test image
*/
@Test
void testUncaughtExceptionOssFuzz33691() throws IOException {
@@ -144,7 +144,7 @@ class PngReadTest extends AbstractPngTest {
* See Google OSS Fuzz issue 37607
* </p>
*
- * @throws IOException if it fails to read the test image
+ * @throws IOException Thrown if it fails to read the test image
*/
@Test
void testUncaughtExceptionOssFuzz37607() throws IOException {
diff --git
a/src/test/java/org/apache/commons/imaging/formats/webp/WebPDumpTest.java
b/src/test/java/org/apache/commons/imaging/formats/webp/WebPDumpTest.java
index cfe8c605..1d7183fb 100644
--- a/src/test/java/org/apache/commons/imaging/formats/webp/WebPDumpTest.java
+++ b/src/test/java/org/apache/commons/imaging/formats/webp/WebPDumpTest.java
@@ -36,7 +36,7 @@ class WebPDumpTest extends AbstractWebPTest {
/**
* @param imageFile parameterized test image.
- * @throws Exception if it cannot open the images.
+ * @throws Exception Thrown if it cannot open the images.
*/
@ParameterizedTest
@MethodSource("images")
diff --git
a/src/test/java/org/apache/commons/imaging/formats/webp/WebPMetadataTest.java
b/src/test/java/org/apache/commons/imaging/formats/webp/WebPMetadataTest.java
index 745ad9ad..29aca028 100644
---
a/src/test/java/org/apache/commons/imaging/formats/webp/WebPMetadataTest.java
+++
b/src/test/java/org/apache/commons/imaging/formats/webp/WebPMetadataTest.java
@@ -36,7 +36,7 @@ import org.junit.jupiter.api.Test;
class WebPMetadataTest extends AbstractWebPTest {
/**
- * @throws Exception if it cannot open the images.
+ * @throws Exception Thrown if it cannot open the images.
*/
@Test
void testReadAlpha() throws Exception {
@@ -47,7 +47,7 @@ class WebPMetadataTest extends AbstractWebPTest {
}
/**
- * @throws Exception if it cannot open the images.
+ * @throws Exception Thrown if it cannot open the images.
*/
@Test
void testReadMetadata() throws Exception {
@@ -66,7 +66,7 @@ class WebPMetadataTest extends AbstractWebPTest {
}
/**
- * @throws Exception if it cannot open the images.
+ * @throws Exception Thrown if it cannot open the images.
*/
@Test
void testReadXmp() throws Exception {
diff --git
a/src/test/java/org/apache/commons/imaging/formats/webp/WebPReadTest.java
b/src/test/java/org/apache/commons/imaging/formats/webp/WebPReadTest.java
index 3c55961a..491d7ca7 100644
--- a/src/test/java/org/apache/commons/imaging/formats/webp/WebPReadTest.java
+++ b/src/test/java/org/apache/commons/imaging/formats/webp/WebPReadTest.java
@@ -44,7 +44,7 @@ class WebPReadTest extends AbstractWebPTest {
/**
* Not implemented yet.
*
- * @throws IOException if it failed to read the image.
+ * @throws IOException Thrown if it failed to read the image.
*/
@Test
void testBufferedImageNotSupported() throws IOException {
@@ -67,7 +67,7 @@ class WebPReadTest extends AbstractWebPTest {
/**
* @param imageFile parameterized test image.
- * @throws Exception if it cannot open the images.
+ * @throws Exception Thrown if it cannot open the images.
*/
@ParameterizedTest
@MethodSource("images")
