diff --git a/src/share/classes/javax/imageio/ImageIO.java b/src/share/classes/javax/imageio/ImageIO.java index 2474bb6582efeb2f326bd9932cfb3abc52bbb85f..62098779a7291c53dd89e5f8e04f9cd4a9c2a247 100644 --- a/src/share/classes/javax/imageio/ImageIO.java +++ b/src/share/classes/javax/imageio/ImageIO.java @@ -228,7 +228,7 @@ public final class ImageIO { * be used when creating ImageInputStreams and * ImageOutputStreams. * - *

When reading from a standard InputStream>, it + *

When reading from a standard InputStream, it * may be necessary to save previously read information in a cache * since the underlying stream does not allow data to be re-read. * Similarly, when writing to a standard diff --git a/src/share/classes/javax/imageio/ImageReadParam.java b/src/share/classes/javax/imageio/ImageReadParam.java index d24b7ef99e7731d10e0a9b645dfa576fb27c8415..6053348d100d3850f4b165116318a9e68e490b9b 100644 --- a/src/share/classes/javax/imageio/ImageReadParam.java +++ b/src/share/classes/javax/imageio/ImageReadParam.java @@ -80,7 +80,7 @@ import java.awt.image.BufferedImage; * *

The resulting region is then subsampled according to the * factors given in {@link IIOParam#setSourceSubsampling - * IIOParam.setSourceSubsampling}. The first pixel, + * IIOParam.setSourceSubsampling}. The first pixel, * the number of pixels per row, and the number of rows all depend * on the subsampling settings. * Call the minimum X and Y coordinates of the resulting rectangle diff --git a/src/share/classes/javax/imageio/ImageReader.java b/src/share/classes/javax/imageio/ImageReader.java index c1d62ababcb510a1edf1636e69333dd598eb53ef..ebbb98324a0784428b6da1715ceab70583ea2010 100644 --- a/src/share/classes/javax/imageio/ImageReader.java +++ b/src/share/classes/javax/imageio/ImageReader.java @@ -230,8 +230,8 @@ public abstract class ImageReader { * increased as each image (or thumbnail, or image metadata) is * read. If seekForwardOnly is true, then a call to * read(index) will throw an - * IndexOutOfBoundsException if index < - * this.minIndex; otherwise, the value of + * IndexOutOfBoundsException if {@code index < this.minIndex}; + * otherwise, the value of * minIndex will be set to index. If * seekForwardOnly is false, the value of * minIndex will remain 0 regardless of any read @@ -328,8 +328,8 @@ public abstract class ImageReader { * increased as each image (or thumbnail, or image metadata) is * read. If seekForwardOnly is true, then a call to * read(index) will throw an - * IndexOutOfBoundsException if index < - * this.minIndex; otherwise, the value of + * IndexOutOfBoundsException if {@code index < this.minIndex}; + * otherwise, the value of * minIndex will be set to index. If * seekForwardOnly is false, the value of * minIndex will remain 0 regardless of any read @@ -600,8 +600,7 @@ public abstract class ImageReader { *

Note that formats that return false from * this method may nonetheless allow tiling (e.g. Restart * Markers in JPEG), and random access will likely be reasonably - * efficient on tiles. See {@link #isImageTiled - * isImageTiled}. + * efficient on tiles. See {@link #isImageTiled isImageTiled}. * *

A reader for which all images are guaranteed to support * easy random access, or are guaranteed not to support easy @@ -1212,11 +1211,10 @@ public abstract class ImageReader { /** * Returns true if this plug-in supports reading - * just a {@link java.awt.image.Raster Raster} of pixel data. + * just a {@link java.awt.image.Raster Raster} of pixel data. * If this method returns false, calls to - * {@link #readRaster readRaster} or {@link #readTileRaster - * readTileRaster} will throw an - * UnsupportedOperationException. + * {@link #readRaster readRaster} or {@link #readTileRaster readTileRaster} + * will throw an UnsupportedOperationException. * *

The default implementation returns false. * @@ -1236,7 +1234,7 @@ public abstract class ImageReader { * application must determine how to interpret the pixel data by other * means. Any destination or image-type parameters in the supplied * ImageReadParam object are ignored, but all other - * parameters are used exactly as in the {@link #read read} + * parameters are used exactly as in the {@link #read read} * method, except that any destination offset is used as a logical rather * than a physical offset. The size of the returned Raster * will always be that of the source region clipped to the actual image. @@ -1249,10 +1247,9 @@ public abstract class ImageReader { * *

Any registered readUpdateListeners are ignored, as * there is no BufferedImage, but all other listeners are - * called exactly as they are for the {@link #read read} - * method. + * called exactly as they are for the {@link #read read} method. * - *

If {@link #canReadRaster canReadRaster()} returns + *

If {@link #canReadRaster canReadRaster()} returns * false, this method throws an * UnsupportedOperationException. * @@ -1481,13 +1478,13 @@ public abstract class ImageReader { * The application must determine how to interpret the pixel data by other * means. * - *

If {@link #canReadRaster canReadRaster()} returns + *

If {@link #canReadRaster canReadRaster()} returns * false, this method throws an * UnsupportedOperationException. * *

The default implementation checks if reading * Rasters is supported, and if so calls {@link - * #readRaster readRaster(imageIndex, null)} if + * #readRaster readRaster(imageIndex, null)} if * tileX and tileY are 0, or throws an * IllegalArgumentException otherwise. * @@ -1548,8 +1545,8 @@ public abstract class ImageReader { * source render size or any format-specific settings), they will * be ignored. * - *

The default implementation just calls {@link #read - * read(imageIndex, param)}. + *

The default implementation just calls + * {@link #read read(imageIndex, param)}. * * @param imageIndex the index of the image to be retrieved. * @param param an ImageReadParam used to control @@ -2544,9 +2541,8 @@ public abstract class ImageReader { * the supplied ImageReadParam. The actual * subsampling factors, destination size, and destination offset * are not taken into consideration, thus further - * clipping must take place. The {@link #computeRegions - * computeRegions} method performs all necessary - * clipping. + * clipping must take place. The {@link #computeRegions computeRegions} + * method performs all necessary clipping. * * @param param the ImageReadParam being used, or * null. @@ -2601,7 +2597,7 @@ public abstract class ImageReader { * width or height of 0, an IllegalArgumentException * is thrown. * - *

The {@link #getSourceRegion getSourceRegion} + *

The {@link #getSourceRegion getSourceRegion>} * method may be used if only source clipping is desired. * * @param param an ImageReadParam, or null. diff --git a/src/share/classes/javax/imageio/ImageTypeSpecifier.java b/src/share/classes/javax/imageio/ImageTypeSpecifier.java index 556f8b76985670fb8eb25f0ded56ba432bab8cca..c9c17dfe4c1d11b77f8fb510defcddfc36f7d5df 100644 --- a/src/share/classes/javax/imageio/ImageTypeSpecifier.java +++ b/src/share/classes/javax/imageio/ImageTypeSpecifier.java @@ -840,7 +840,7 @@ public class ImageTypeSpecifier { * not one of 1, 2, 4, 8, or 16. * @exception IllegalArgumentException if the * non-null LUT parameters do not have lengths of - * exactly 1 << bits. + * exactly {@code 1 << bits}. * @exception IllegalArgumentException if dataType is * not one of DataBuffer.TYPE_BYTE, * DataBuffer.TYPE_SHORT, diff --git a/src/share/classes/javax/imageio/ImageWriteParam.java b/src/share/classes/javax/imageio/ImageWriteParam.java index 4db0e591ea659de8fe11caea4b03450175631b42..adf4f3a9029913a48dcd4ebf50da4e8494f43630 100644 --- a/src/share/classes/javax/imageio/ImageWriteParam.java +++ b/src/share/classes/javax/imageio/ImageWriteParam.java @@ -49,7 +49,7 @@ import java.util.Locale; * and include additional pixels within the intersected bounds * according to the horizontal and vertical subsampling factors * specified by {@link IIOParam#setSourceSubsampling - * IIOParam.setSourceSubsampling}. + * IIOParam.setSourceSubsampling}. * *

Individual features such as tiling, progressive encoding, and * compression may be set in one of four modes. @@ -462,9 +462,8 @@ public class ImageWriteParam extends IIOParam { * IllegalStateException. * *

  • MODE_EXPLICIT - The image will be tiled - * according to parameters given in the {@link #setTiling - * setTiling} method. Any previously set tiling - * parameters are discarded. + * according to parameters given in the {@link #setTiling setTiling} + * method. Any previously set tiling parameters are discarded. * *
  • MODE_COPY_FROM_METADATA - The image will * conform to the metadata object passed in to a write. @@ -1421,7 +1420,7 @@ public class ImageWriteParam extends IIOParam { * with getCompressionQualityDescriptions as part of a user * interface for setting or displaying the compression quality * level. See {@link #getCompressionQualityDescriptions - * getCompressionQualityDescriptions} for more information. + * getCompressionQualityDescriptions} for more information. * *

    If no descriptions are available, null is * returned. If null is returned from diff --git a/src/share/classes/javax/imageio/ImageWriter.java b/src/share/classes/javax/imageio/ImageWriter.java index a9ecb042b3eec37f1242c50a10b8ebf071dbec24..1fdabdcd5f83234455672824aea5554b2ff8e2c8 100644 --- a/src/share/classes/javax/imageio/ImageWriter.java +++ b/src/share/classes/javax/imageio/ImageWriter.java @@ -692,7 +692,7 @@ public abstract class ImageWriter implements ImageTranscoder { * output prior to the current seek position may be flushed, and * need not be readable or writable, unless the plug-in needs to * be able to patch up the header information when - * endWriteSequence is called (e.g. TIFF). + * endWriteSequence is called (e.g. TIFF). * *

    If canWriteSequence returns false, * this method will throw an diff --git a/src/share/classes/javax/imageio/metadata/IIOMetadataFormatImpl.java b/src/share/classes/javax/imageio/metadata/IIOMetadataFormatImpl.java index 1a68b019d593238dc8504fa3d252757933564e11..4ca4f74c4a0b365cdae04e07f659ab907dd61227 100644 --- a/src/share/classes/javax/imageio/metadata/IIOMetadataFormatImpl.java +++ b/src/share/classes/javax/imageio/metadata/IIOMetadataFormatImpl.java @@ -729,6 +729,7 @@ public abstract class IIOMetadataFormatImpl implements IIOMetadataFormat { * @param required true if an object value must be present. * @param defaultValue the default value for the * Object reference, or null. + * @param the type of the object. * * @exception IllegalArgumentException if elementName * is null, or is not a legal element name for this format. @@ -765,6 +766,7 @@ public abstract class IIOMetadataFormatImpl implements IIOMetadataFormat { * @param enumeratedValues a List of * Objects containing the legal values for the * object reference. + * @param the type of the object. * * @exception IllegalArgumentException if elementName * is null, or is not a legal element name for this format. @@ -836,6 +838,7 @@ public abstract class IIOMetadataFormatImpl implements IIOMetadataFormat { * is inclusive. * @param maxInclusive true if maxValue * is inclusive. + * @param the type of the object. * * @exception IllegalArgumentException if elementName * is null, or is not a legal element name for this diff --git a/src/share/classes/javax/imageio/plugins/bmp/BMPImageWriteParam.java b/src/share/classes/javax/imageio/plugins/bmp/BMPImageWriteParam.java index 840e6c3f223dcf8ea43357c2e9b97deba6cbd81e..de35f5fe11edbbdea4c8ca56b5b9635df8418503 100644 --- a/src/share/classes/javax/imageio/plugins/bmp/BMPImageWriteParam.java +++ b/src/share/classes/javax/imageio/plugins/bmp/BMPImageWriteParam.java @@ -56,9 +56,9 @@ import com.sun.imageio.plugins.bmp.BMPConstants; *

    * * - * - * - * + * + * + * * *
    Compression Types
    Type String Description Image Types
    BI_RGB Uncompressed RLE <= 8-bits/sample
    BI_RLE8 8-bit Run Length Encoding <= 8-bits/sample
    BI_RLE4 4-bit Run Length Encoding <= 4-bits/sample
    BI_RGB Uncompressed RLE {@literal <= } 8-bits/sample
    BI_RLE8 8-bit Run Length Encoding {@literal <=} 8-bits/sample
    BI_RLE4 4-bit Run Length Encoding {@literal <=} 4-bits/sample
    BI_BITFIELDS Packed data 16 or 32 bits/sample
    */ diff --git a/src/share/classes/javax/imageio/plugins/jpeg/JPEGImageReadParam.java b/src/share/classes/javax/imageio/plugins/jpeg/JPEGImageReadParam.java index 269c03acc5ba4046b3cedd0bdb41c2902d6f1a67..720aa600129fe15cd86bff7c00726aea0dbaff03 100644 --- a/src/share/classes/javax/imageio/plugins/jpeg/JPEGImageReadParam.java +++ b/src/share/classes/javax/imageio/plugins/jpeg/JPEGImageReadParam.java @@ -46,16 +46,15 @@ import javax.imageio.ImageReadParam; * This class allows the tables to be specified directly from client * code. If no tables are specified either in the stream or in a * JPEGImageReadParam, then the stream is presumed to use - * the "standard" visually lossless tables. See {@link JPEGQTable - * JPEGQTable} and {@link JPEGHuffmanTable - * JPEGHuffmanTable} for more information on the default - * tables. + * the "standard" visually lossless tables. See {@link JPEGQTable JPEGQTable} + * and {@link JPEGHuffmanTable JPEGHuffmanTable} for more information + * on the default tables. * *

    The default JPEGImageReadParam returned by the * getDefaultReadParam method of the builtin JPEG reader * contains no tables. Default tables may be obtained from the table - * classes {@link JPEGQTable JPEGQTable} and {@link - * JPEGHuffmanTable JPEGHuffmanTable}. + * classes {@link JPEGQTable JPEGQTable} and + * {@link JPEGHuffmanTable JPEGHuffmanTable}. * *

    If a stream does contain tables, the tables given in a * JPEGImageReadParam are ignored. Furthermore, if the @@ -64,13 +63,12 @@ import javax.imageio.ImageReadParam; * abbreviated images. Once tables have been read from a stream, they * can be overridden only by tables subsequently read from the same * stream. In order to specify new tables, the {@link - * javax.imageio.ImageReader#setInput setInput} method of + * javax.imageio.ImageReader#setInput setInput} method of * the reader must be called to change the stream. * *

    Note that this class does not provide a means for obtaining the * tables found in a stream. These may be extracted from a stream by - * consulting the IIOMetadata object returned by the - * reader. + * consulting the IIOMetadata object returned by the reader. * *

    * For more information about the operation of the built-in JPEG plug-ins, diff --git a/src/share/classes/javax/imageio/plugins/jpeg/JPEGImageWriteParam.java b/src/share/classes/javax/imageio/plugins/jpeg/JPEGImageWriteParam.java index 4e8a35cbefa2efd355e3ebc77c75c836f9f862f3..b4df14e99c68199d4f98cc02d1da5302f6c26a8e 100644 --- a/src/share/classes/javax/imageio/plugins/jpeg/JPEGImageWriteParam.java +++ b/src/share/classes/javax/imageio/plugins/jpeg/JPEGImageWriteParam.java @@ -66,8 +66,8 @@ import com.sun.imageio.plugins.jpeg.JPEG; * when an abbreviated stream must be written without writing any tables * to a stream first. In order to use this class, the metadata object * passed into the writer must contain no tables, and no stream metadata - * must be provided. See {@link JPEGQTable JPEGQTable} and - * {@link JPEGHuffmanTable JPEGHuffmanTable} for more + * must be provided. See {@link JPEGQTable JPEGQTable} and + * {@link JPEGHuffmanTable JPEGHuffmanTable} for more * information on the default tables. * *

    The default JPEGImageWriteParam returned by the @@ -80,7 +80,7 @@ import com.sun.imageio.plugins.jpeg.JPEG; * set of tables has been written, only tables in the metadata can * override them for subsequent writes, whether to the same stream or * a different one. In order to specify new tables using this class, - * the {@link javax.imageio.ImageWriter#reset reset} + * the {@link javax.imageio.ImageWriter#reset reset} * method of the writer must be called. * *

    diff --git a/src/share/classes/javax/imageio/spi/ImageReaderSpi.java b/src/share/classes/javax/imageio/spi/ImageReaderSpi.java index 969bc8d9a4d0c64a6739c41122378801b707ba03..4d4ccec0fa6028cd35f6f667f591658500a39953 100644 --- a/src/share/classes/javax/imageio/spi/ImageReaderSpi.java +++ b/src/share/classes/javax/imageio/spi/ImageReaderSpi.java @@ -78,7 +78,7 @@ public abstract class ImageReaderSpi extends ImageReaderWriterSpi { * ImageInputStream.class, to be returned from * getInputTypes. * @deprecated Instead of using this field, directly create - * the equivalent array { ImageInputStream.class }. + * the equivalent array { ImageInputStream.class }. */ @Deprecated public static final Class[] STANDARD_INPUT_TYPE = diff --git a/src/share/classes/javax/imageio/spi/ImageWriterSpi.java b/src/share/classes/javax/imageio/spi/ImageWriterSpi.java index b6e0c9e46daf7f1f0826f33c78b4d77a5c362645..7fc1a334a9fb6bcdcc80358b87c65e8a9660dec4 100644 --- a/src/share/classes/javax/imageio/spi/ImageWriterSpi.java +++ b/src/share/classes/javax/imageio/spi/ImageWriterSpi.java @@ -80,7 +80,7 @@ public abstract class ImageWriterSpi extends ImageReaderWriterSpi { * ImageOutputStream.class, to be returned from * getOutputTypes. * @deprecated Instead of using this field, directly create - * the equivalent array { ImageOutputStream.class }. + * the equivalent array { ImageOutputStream.class }. */ @Deprecated public static final Class[] STANDARD_OUTPUT_TYPE = diff --git a/src/share/classes/javax/imageio/spi/ServiceRegistry.java b/src/share/classes/javax/imageio/spi/ServiceRegistry.java index c94c98d0359eb4b7c5d2337db5345b5249f075cf..3f4338d7db9977a6df4d2dc386ad7808ee1eba41 100644 --- a/src/share/classes/javax/imageio/spi/ServiceRegistry.java +++ b/src/share/classes/javax/imageio/spi/ServiceRegistry.java @@ -157,6 +157,8 @@ public class ServiceRegistry { * or null if the system class loader (or, failing that * the bootstrap class loader) is to be used. * + * @param the type of the providerClass. + * * @return An Iterator that yields provider objects * for the given service, in some arbitrary order. The iterator * will throw an Error if a provider-configuration @@ -188,6 +190,8 @@ public class ServiceRegistry { * @param providerClass a Classobject indicating the * class or interface of the service providers being detected. * + * @param the type of the providerClass. + * * @return An Iterator that yields provider objects * for the given service, in some arbitrary order. The iterator * will throw an Error if a provider-configuration @@ -247,6 +251,7 @@ public class ServiceRegistry { * @param provider the service provide object to be registered. * @param category the category under which to register the * provider. + * @param the type of the provider. * * @return true if no provider of the same class was previously * registered in the same category category. @@ -348,6 +353,7 @@ public class ServiceRegistry { * @param provider the service provider object to be deregistered. * @param category the category from which to deregister the * provider. + * @param the type of the provider. * * @return true if the provider was previously * registered in the same category category, @@ -435,6 +441,7 @@ public class ServiceRegistry { * @param category the category to be retrieved from. * @param useOrdering true if pairwise orderings * should be taken account in ordering the returned objects. + * @param the type of the category. * * @return an Iterator containing service provider * objects from the given category, possibly in order. @@ -490,6 +497,7 @@ public class ServiceRegistry { * whose filter method will be invoked. * @param useOrdering true if pairwise orderings * should be taken account in ordering the returned objects. + * @param the type of the category. * * @return an Iterator containing service provider * objects from the given category, possibly in order. @@ -517,6 +525,7 @@ public class ServiceRegistry { * * @param providerClass the Class of the desired * service provider object. + * @param the type of the provider. * * @return a currently registered service provider object with the * desired Classtype, or null is none is @@ -561,6 +570,7 @@ public class ServiceRegistry { * @param firstProvider the preferred provider. * @param secondProvider the provider to which * firstProvider is preferred. + * @param the type of the category. * * @return true if a previously unset ordering * was established. @@ -606,6 +616,7 @@ public class ServiceRegistry { * @param firstProvider the formerly preferred provider. * @param secondProvider the provider to which * firstProvider was formerly preferred. + * @param the type of the category. * * @return true if a previously set ordering was * disestablished. diff --git a/src/share/classes/javax/imageio/stream/ImageInputStream.java b/src/share/classes/javax/imageio/stream/ImageInputStream.java index d51f22aa8b60545754321f65825eb35171f1b74f..ebf984a9ddc44da0ec79c9a826556e20fe8163ad 100644 --- a/src/share/classes/javax/imageio/stream/ImageInputStream.java +++ b/src/share/classes/javax/imageio/stream/ImageInputStream.java @@ -183,7 +183,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return a boolean value from the stream. * - * @exception EOFException if the end of the stream is reached. + * @exception java.io.EOFException if the end of the stream is reached. * @exception IOException if an I/O error occurs. */ boolean readBoolean() throws IOException; @@ -201,7 +201,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return a signed byte value from the stream. * - * @exception EOFException if the end of the stream is reached. + * @exception java.io.EOFException if the end of the stream is reached. * @exception IOException if an I/O error occurs. */ byte readByte() throws IOException; @@ -225,7 +225,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return an unsigned byte value from the stream. * - * @exception EOFException if the end of the stream is reached. + * @exception java.io.EOFException if the end of the stream is reached. * @exception IOException if an I/O error occurs. */ int readUnsignedByte() throws IOException; @@ -240,7 +240,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return a signed short value from the stream. * - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. * @@ -261,7 +261,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return an unsigned short value from the stream, as an int. * - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. * @@ -278,7 +278,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return an unsigned char value from the stream. * - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. * @@ -296,7 +296,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return a signed int value from the stream. * - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. * @@ -316,7 +316,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return an unsigned int value from the stream, as a long. * - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. * @@ -334,7 +334,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return a signed long value from the stream. * - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. * @@ -352,7 +352,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return a float value from the stream. * - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. * @@ -370,7 +370,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return a double value from the stream. * - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. * @@ -469,7 +469,7 @@ public interface ImageInputStream extends DataInput, Closeable { * then a UTFDataFormatException is thrown. * *

    If end of file is encountered at any time during this - * entire process, then an EOFException is thrown. + * entire process, then an java.io.EOFException is thrown. * *

    After every group has been converted to a character by this * process, the characters are gathered, in the same order in @@ -488,10 +488,10 @@ public interface ImageInputStream extends DataInput, Closeable { * * @return a String read from the stream. * - * @exception EOFException if this stream reaches the end + * @exception java.io.EOFException if this stream reaches the end * before reading all the bytes. - * @exception UTFDataFormatException if the bytes do not represent a - * valid modified UTF-8 encoding of a string. + * @exception java.io.UTFDataFormatException if the bytes do not represent + * a valid modified UTF-8 encoding of a string. * @exception IOException if an I/O error occurs. */ String readUTF() throws IOException; @@ -499,7 +499,7 @@ public interface ImageInputStream extends DataInput, Closeable { /** * Reads len bytes from the stream, and stores them * into b starting at index off. - * If the end of the stream is reached, an EOFException + * If the end of the stream is reached, an java.io.EOFException * will be thrown. * *

    The bit offset within the stream is reset to zero before @@ -514,7 +514,7 @@ public interface ImageInputStream extends DataInput, Closeable { * len is greater than b.length. * @exception NullPointerException if b is * null. - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. */ @@ -523,7 +523,7 @@ public interface ImageInputStream extends DataInput, Closeable { /** * Reads b.length bytes from the stream, and stores them * into b starting at index 0. - * If the end of the stream is reached, an EOFException + * If the end of the stream is reached, an java.io.EOFException * will be thrown. * *

    The bit offset within the stream is reset to zero before @@ -533,7 +533,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @exception NullPointerException if b is * null. - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. */ @@ -544,7 +544,7 @@ public interface ImageInputStream extends DataInput, Closeable { * stream according to the current byte order, and * stores them into s starting at index * off. If the end of the stream is reached, an - * EOFException will be thrown. + * java.io.EOFException will be thrown. * *

    The bit offset within the stream is reset to zero before * the read occurs. @@ -558,7 +558,7 @@ public interface ImageInputStream extends DataInput, Closeable { * len is greater than s.length. * @exception NullPointerException if s is * null. - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. */ @@ -569,7 +569,7 @@ public interface ImageInputStream extends DataInput, Closeable { * stream according to the current byte order, and * stores them into c starting at index * off. If the end of the stream is reached, an - * EOFException will be thrown. + * java.io.EOFException will be thrown. * *

    The bit offset within the stream is reset to zero before * the read occurs. @@ -583,7 +583,7 @@ public interface ImageInputStream extends DataInput, Closeable { * len is greater than c.length. * @exception NullPointerException if c is * null. - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. */ @@ -594,7 +594,7 @@ public interface ImageInputStream extends DataInput, Closeable { * stream according to the current byte order, and * stores them into i starting at index * off. If the end of the stream is reached, an - * EOFException will be thrown. + * java.io.EOFException will be thrown. * *

    The bit offset within the stream is reset to zero before * the read occurs. @@ -608,7 +608,7 @@ public interface ImageInputStream extends DataInput, Closeable { * len is greater than i.length. * @exception NullPointerException if i is * null. - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. */ @@ -619,7 +619,7 @@ public interface ImageInputStream extends DataInput, Closeable { * stream according to the current byte order, and * stores them into l starting at index * off. If the end of the stream is reached, an - * EOFException will be thrown. + * java.io.EOFException will be thrown. * *

    The bit offset within the stream is reset to zero before * the read occurs. @@ -633,7 +633,7 @@ public interface ImageInputStream extends DataInput, Closeable { * len is greater than l.length. * @exception NullPointerException if l is * null. - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. */ @@ -644,7 +644,7 @@ public interface ImageInputStream extends DataInput, Closeable { * floats) from the stream according to the current byte order, * and stores them into f starting at * index off. If the end of the stream is reached, - * an EOFException will be thrown. + * an java.io.EOFException will be thrown. * *

    The bit offset within the stream is reset to zero before * the read occurs. @@ -658,7 +658,7 @@ public interface ImageInputStream extends DataInput, Closeable { * len is greater than f.length. * @exception NullPointerException if f is * null. - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. */ @@ -669,7 +669,7 @@ public interface ImageInputStream extends DataInput, Closeable { * floats) from the stream according to the current byte order, * and stores them into d starting at * index off. If the end of the stream is reached, - * an EOFException will be thrown. + * an java.io.EOFException will be thrown. * *

    The bit offset within the stream is reset to zero before * the read occurs. @@ -683,7 +683,7 @@ public interface ImageInputStream extends DataInput, Closeable { * len is greater than d.length. * @exception NullPointerException if d is * null. - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bytes. * @exception IOException if an I/O error occurs. */ @@ -748,7 +748,7 @@ public interface ImageInputStream extends DataInput, Closeable { * @return an int containing the value 0 * or 1. * - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bits. * @exception IOException if an I/O error occurs. */ @@ -768,13 +768,13 @@ public interface ImageInputStream extends DataInput, Closeable { * the right side of the return value, as shown by the following * pseudo-code: * - *

    +     * 
    {@code
          * long accum = 0L;
          * for (int i = 0; i < numBits; i++) {
          *   accum <<= 1; // Shift left one bit to make room
          *   accum |= readBit();
          * }
    -     * 
    + * }
    * * Note that the result of readBits(32) may thus not * be equal to that of readInt() if a reverse network @@ -782,7 +782,7 @@ public interface ImageInputStream extends DataInput, Closeable { * false). * *

    If the end of the stream is encountered before all the bits - * have been read, an EOFException is thrown. + * have been read, an java.io.EOFException is thrown. * * @param numBits the number of bits to read, as an int * between 0 and 64, inclusive. @@ -791,7 +791,7 @@ public interface ImageInputStream extends DataInput, Closeable { * * @exception IllegalArgumentException if numBits * is not between 0 and 64, inclusive. - * @exception EOFException if the stream reaches the end before + * @exception java.io.EOFException if the stream reaches the end before * reading all the bits. * @exception IOException if an I/O error occurs. */ @@ -850,7 +850,7 @@ public interface ImageInputStream extends DataInput, Closeable { * returned by getflushedPosition). * *

    It is legal to seek past the end of the file; an - * EOFException will be thrown only if a read is + * java.io.EOFException will be thrown only if a read is * performed. * * @param pos a long containing the desired file diff --git a/src/share/classes/javax/imageio/stream/ImageInputStreamImpl.java b/src/share/classes/javax/imageio/stream/ImageInputStreamImpl.java index cf66019768bc768402feee798862e4cdb7bc03cf..8f7061f960ec7dcef1cc7652307c76cdb8b7ff53 100644 --- a/src/share/classes/javax/imageio/stream/ImageInputStreamImpl.java +++ b/src/share/classes/javax/imageio/stream/ImageInputStreamImpl.java @@ -88,7 +88,7 @@ public abstract class ImageInputStreamImpl implements ImageInputStream { /** * The position prior to which data may be discarded. Seeking * to a smaller position is not allowed. flushedPos - * will always be >= 0. + * will always be {@literal >= 0}. */ protected long flushedPos = 0; diff --git a/src/share/classes/javax/imageio/stream/ImageOutputStream.java b/src/share/classes/javax/imageio/stream/ImageOutputStream.java index c525ca39c1ed651f1c2d71b78591685b00214caa..8deddd3b36b0b2dbe2dc07795210d4970aa16e52 100644 --- a/src/share/classes/javax/imageio/stream/ImageOutputStream.java +++ b/src/share/classes/javax/imageio/stream/ImageOutputStream.java @@ -59,9 +59,9 @@ public interface ImageOutputStream extends ImageInputStream, DataOutput { * remainder of the current byte is padded with 0s * and written out first. The bit offset will be 0 after the * write. Implementers can use the - * {@link ImageOutputStreamImpl#flushBits flushBits} - * method of {@link ImageOutputStreamImpl - * ImageOutputStreamImpl} to guarantee this. + * {@link ImageOutputStreamImpl#flushBits flushBits} + * method of {@link ImageOutputStreamImpl ImageOutputStreamImpl} + * to guarantee this. * * @param b an int whose lower 8 bits are to be * written. @@ -99,9 +99,9 @@ public interface ImageOutputStream extends ImageInputStream, DataOutput { * remainder of the current byte is padded with 0s * and written out first. The bit offset will be 0 after the * write. Implementers can use the - * {@link ImageOutputStreamImpl#flushBits flushBits} - * method of {@link ImageOutputStreamImpl - * ImageOutputStreamImpl} to guarantee this. + * {@link ImageOutputStreamImpl#flushBits flushBits} + * method of {@link ImageOutputStreamImpl ImageOutputStreamImpl} + * to guarantee this. * * @param b an array of bytes to be written. * @param off the start offset in the data. @@ -182,8 +182,7 @@ public interface ImageOutputStream extends ImageInputStream, DataOutput { void writeShort(int v) throws IOException; /** - * This method is a synonym for - * {@link #writeShort writeShort}. + * This method is a synonym for {@link #writeShort writeShort}. * * @param v an int containing the char (unsigned * short) value to be written. @@ -430,7 +429,7 @@ public interface ImageOutputStream extends ImageInputStream, DataOutput { * * @exception NullPointerException if s is * null. - * @exception UTFDataFormatException if the modified UTF-8 + * @exception java.io.UTFDataFormatException if the modified UTF-8 * representation of s requires more than 65536 bytes. * @exception IOException if an I/O error occurs. */