Javadoc

Add an empty line before a Javadoc comment

Author: garydgregory

src/main/java/org/apache/commons/imaging/ImageFormats.java

@@ -25,48 +25,70 @@ public enum ImageFormats implements ImageFormat {
 
     /** Unknown image format. */
     UNKNOWN("bin"),
+
     /** BMP (Windows Bitmap) image format. */
     BMP("bmp", "dib"),
+
     /** DCX (ZSoft Multi-page Paintbrush) image format. */
     DCX("dcx"),
+
     /** GIF (Graphics Interchange Format) image format. */
     GIF("gif"),
+
     /** ICNS (Apple Icon Image) format. */
     ICNS("icns"),
+
     /** ICO (Windows Icon) image format. */
     ICO("ico"),
+
     /** JBIG2 image format. */
     JBIG2("jbig2"),
+
     /** JPEG (Joint Photographic Experts Group) image format. */
     JPEG("jpg", "jpeg"),
+
     /** PAM (Portable Arbitrary Map) image format. */
     PAM("pam"),
+
     /** PSD (Adobe Photoshop Document) image format. */
     PSD("psd"),
+
     /** PBM (Portable Bitmap) image format. */
     PBM("pbm"),
+
     /** PGM (Portable Graymap) image format. */
     PGM("pgm"),
+
     /** PNM (Portable Any Map) image format. */
     PNM("pnm"),
+
     /** PPM (Portable Pixmap) image format. */
     PPM("ppm"),
+
     /** PCX (PC Paintbrush) image format. */
     PCX("pcx", "pcc"),
+
     /** PNG (Portable Network Graphics) image format. */
     PNG("png"),
+
     /** RGBE (Radiance HDR) image format. */
     RGBE("hdr", "pic"),
+
     /** TGA (Truevision TGA/TARGA) image format. */
     TGA("tga"),
+
     /** TIFF (Tagged Image File Format). */
     TIFF("tif", "tiff"),
+
     /** WBMP (Wireless Bitmap) image format. */
     WBMP("wbmp"),
+
     /** WebP image format. */
     WEBP("webp"),
+
     /** XBM (X11 Bitmap) image format. */
     XBM("xbm"),
+
     /** XPM (X11 Pixmap) image format. */
     XPM("xpm");
 

src/main/java/org/apache/commons/imaging/ImageInfo.java

@@ -30,22 +30,31 @@ public class ImageInfo {
 
     /** Color type enumeration for images. */
     public enum ColorType {
+
         /** Black and white images. */
         BW("Black and White"),
+
         /** Grayscale images. */
         GRAYSCALE("Grayscale"),
+
         /** RGB color images. */
         RGB("RGB"),
+
         /** CMYK color images. */
         CMYK("CMYK"),
+
         /** YCbCr color images. */
         YCbCr("YCbCr"),
+
         /** YCCK color images. */
         YCCK("YCCK"),
+
         /** YCC color images. */
         YCC("YCC"),
+
         /** Other color type. */
         OTHER("Other"),
+
         /** Unknown color type. */
         UNKNOWN("Unknown");
 
@@ -63,32 +72,46 @@ public String toString() {
 
     /** Compression algorithm enumeration for images. */
     public enum CompressionAlgorithm {
+
         /** Unknown compression. */
         UNKNOWN("Unknown"),
+
         /** No compression. */
         NONE("None"),
+
         /** LZW compression. */
         LZW("LZW"),
+
         /** PackBits compression. */
         PACKBITS("PackBits"),
+
         /** JPEG compression (TIFF obsolete). */
         JPEG_TIFF_OBSOLETE("JPEG Obsolete (TIFF only)"),
+
         /** JPEG compression. */
         JPEG("JPEG"),
+
         /** RLE: Run-Length Encoding. */
         RLE("RLE: Run-Length Encoding"),
+
         /** Adaptive RLE compression. */
         ADAPTIVE_RLE("Adaptive RLE"),
+
         /** Photoshop compression. */
         PSD("Photoshop"),
+
         /** PNG Filter compression. */
         PNG_FILTER("PNG Filter"),
+
         /** CCITT Group 3 1-Dimensional Modified Huffman run-length encoding. */
         CCITT_GROUP_3("CCITT Group 3 1-Dimensional Modified Huffman run-length encoding."),
+
         /** CCITT Group 4 compression. */
         CCITT_GROUP_4("CCITT Group 4"),
+
         /** CCITT 1D compression. */
         CCITT_1D("CCITT 1D"),
+
         /** DEFLATE (ZIP) compression. */
         DEFLATE("DEFLATE (ZIP)");
 

src/main/java/org/apache/commons/imaging/common/BasicCParser.java

@@ -32,6 +32,7 @@
  * FIXME replace this by a parser generated via ANTLR (if we really need it?!)
  */
 public class BasicCParser {
+
     /**
      * Parses the hexadecimal-base escape-sequence found at index {@code i} of {@code string}.
      *

src/main/java/org/apache/commons/imaging/common/ImageMetadata.java

@@ -22,6 +22,7 @@
  * Image metadata.
  */
 public interface ImageMetadata {
+
     /**
      * Represents a single metadata item.
      */

src/main/java/org/apache/commons/imaging/formats/jpeg/iptc/IptcRecord.java

@@ -22,8 +22,10 @@
  * Represents an IPTC record, a single key-value pair of Photoshop IPTC data.
  */
 public class IptcRecord {
+
     /** Comparator for sorting IPTC records by type. */
     public static final Comparator<IptcRecord> COMPARATOR = Comparator.comparingInt(e -> e.iptcType.getType());
+
     /** The IPTC type. */
     public final IptcType iptcType;
     private final String value;

src/main/java/org/apache/commons/imaging/formats/jpeg/iptc/IptcType.java

@@ -20,6 +20,7 @@
  * IPTC metadata types.
  */
 public interface IptcType {
+
     /**
      * Gets the name of this IPTC type.
      *

src/main/java/org/apache/commons/imaging/formats/jpeg/iptc/IptcTypes.java

@@ -20,118 +20,175 @@
  * Enumeration of IPTC (International Press Telecommunications Council) metadata record types.
  */
 public enum IptcTypes implements IptcType {
+
     /** Record version type. */
     RECORD_VERSION(0, "Record Version"),
+
     /** Object type reference type. */
     OBJECT_TYPE_REFERENCE(3, "Object Type Reference"),
+
     /** Object attribute reference type. */
     OBJECT_ATTRIBUTE_REFERENCE(4, "Object Attribute Reference"),
+
     /** Object name type. */
     OBJECT_NAME(5, "Object Name"),
+
     /** Edit status type. */
     EDIT_STATUS(7, "Edit Status"),
+
     /** Editorial update type. */
     EDITORIAL_UPDATE(8, "Editorial Update"),
+
     /** Urgency type. */
     URGENCY(10, "Urgency"),
+
     /** Subject reference type. */
     SUBJECT_REFERENCE(12, "Subject Reference"),
+
     /** Category type. */
     CATEGORY(15, "Category"),
+
     /** Supplemental category type. */
     SUPPLEMENTAL_CATEGORY(20, "Supplemental Category"),
+
     /** Fixture identifier type. */
     FIXTURE_IDENTIFIER(22, "Fixture Identifier"),
+
     /** Keywords type. */
     KEYWORDS(25, "Keywords"),
+
     /** Content location code type. */
     CONTENT_LOCATION_CODE(26, "Content Location Code"),
+
     /** Content location name type. */
     CONTENT_LOCATION_NAME(27, "Content Location Name"),
+
     /** Release date type. */
     RELEASE_DATE(30, "Release Date"),
+
     /** Release time type. */
     RELEASE_TIME(35, "Release Time"),
+
     /** Expiration date type. */
     EXPIRATION_DATE(37, "Expiration Date"),
+
     /** Expiration time type. */
     EXPIRATION_TIME(38, "Expiration Time"),
+
     /** Special instructions type. */
     SPECIAL_INSTRUCTIONS(40, "Special Instructions"),
+
     /** Action advised type. */
     ACTION_ADVISED(42, "Action Advised"),
+
     /** Reference service type. */
     REFERENCE_SERVICE(45, "Reference Service"),
+
     /** Reference date type. */
     REFERENCE_DATE(47, "Reference Date"),
+
     /** Reference number type. */
     REFERENCE_NUMBER(50, "Reference Number"),
+
     /** Date created type. */
     DATE_CREATED(55, "Date Created"),
+
     /** Time created type. */
     TIME_CREATED(60, "Time Created"),
+
     /** Digital creation date type. */
     DIGITAL_CREATION_DATE(62, "Digital Creation Date"),
+
     /** Digital creation time type. */
     DIGITAL_CREATION_TIME(63, "Digital Creation Time"),
+
     /** Originating program type. */
     ORIGINATING_PROGRAM(65, "Originating Program"),
+
     /** Program version type. */
     PROGRAM_VERSION(70, "Program Version"),
+
     /** Object cycle type. */
     OBJECT_CYCLE(75, "Object Cycle"),
+
     /** By-line type. */
     BYLINE(80, "By-line"),
+
     /** By-line title type. */
     BYLINE_TITLE(85, "By-line Title"),
+
     /** City type. */
     CITY(90, "City"),
+
     /** Sublocation type. */
     SUBLOCATION(92, "Sublocation"),
+
     /** Province/State type. */
     PROVINCE_STATE(95, "Province/State"),
+
     /** Country/Primary location code type. */
     COUNTRY_PRIMARY_LOCATION_CODE(100, "Country/Primary Location Code"),
+
     /** Country/Primary location name type. */
     COUNTRY_PRIMARY_LOCATION_NAME(101, "Country/Primary Location Name"),
+
     /** Original transmission reference type. */
     ORIGINAL_TRANSMISSION_REFERENCE(103, "Original Transmission, Reference"),
+
     /** Headline type. */
     HEADLINE(105, "Headline"),
+
     /** Credit type. */
     CREDIT(110, "Credit"),
+
     /** Source type. */
     SOURCE(115, "Source"),
+
     /** Copyright notice type. */
     COPYRIGHT_NOTICE(116, "Copyright Notice"),
+
     /** Contact type. */
     CONTACT(118, "Contact"),
+
     /** Caption/Abstract type. */
     CAPTION_ABSTRACT(120, "Caption/Abstract"),
+
     /** Writer/Editor type. */
     WRITER_EDITOR(122, "Writer/Editor"),
+
     /** Rasterized caption type. */
     RASTERIZED_CAPTION(125, "Rasterized Caption"),
+
     /** Image type. */
     IMAGE_TYPE(130, "ImageType"),
+
     /** Image orientation type. */
     IMAGE_ORIENTATION(131, "Image Orientation"),
+
     /** Language identifier type. */
     LANGUAGE_IDENTIFIER(135, "Language Identifier"),
+
     /** Audio type. */
     AUDIO_TYPE(150, "Audio Type"),
+
     /** Audio sampling rate type. */
     AUDIO_SAMPLING_RATE(151, "Audio Sampling Rate"),
+
     /** Audio sampling resolution type. */
     AUDIO_SAMPLING_RESOLUTION(152, "Audio Sampling Resolution"),
+
     /** Audio duration type. */
     AUDIO_DURATION(153, "Audio Duration"),
+
     /** Audio outcue type. */
     AUDIO_OUTCUE(154, "Audio Outcue"),
+
     /** Object data preview file format type. */
     OBJECT_DATA_PREVIEW_FILE_FORMAT(200, "Object Data Preview, File Format"),
+
     /** Object data preview file format version type. */
     OBJECT_DATA_PREVIEW_FILE_FORMAT_VERSION(201, "Object Data Preview, File Format Version"),
+
     /** Object data preview data type. */
     OBJECT_DATA_PREVIEW_DATA(202, "Object Data Preview Data");
 

src/main/java/org/apache/commons/imaging/formats/jpeg/segments/DqtSegment.java

@@ -35,6 +35,7 @@ public final class DqtSegment extends AbstractSegment {
      * A quantization table for JPEG compression.
      */
     public static class QuantizationTable {
+
         /** The precision of the quantization table (0=8-bit, 1=16-bit). */
         public final int precision;