Improve itextcore's javadocs.

Do not use paragraph's end tags for separation reasons in Javadoc.
Javadoc isn't xml-based. It has its own markdown.

The changes have been inplemented during the third technical-debt session.

DEVSIX-3096

Author: ars18wrw

barcodes/src/main/java/com/itextpdf/barcodes/qrcode/BitArray.java

@@ -45,7 +45,8 @@ This file is part of the iText (R) project.
 
 
 /**
- * <p>A simple, fast array of bits, represented compactly by an array of ints internally.</p>
+ * A simple, fast array of bits, represented compactly by an array of ints internally.
+ *
  * @author Sean Owen
  */
 final class BitArray {

barcodes/src/main/java/com/itextpdf/barcodes/qrcode/BitMatrix.java

@@ -44,16 +44,16 @@ This file is part of the iText (R) project.
 package com.itextpdf.barcodes.qrcode;
 
 /**
- * <p>Represents a 2D matrix of bits. In function arguments below, and throughout the common
+ * Represents a 2D matrix of bits. In function arguments below, and throughout the common
  * module, x is the column position, and y is the row position. The ordering is always x, y.
- * The origin is at the top-left.</p>
- *
- * <p>Internally the bits are represented in a 1-D array of 32-bit ints. However, each row begins
+ * The origin is at the top-left.
+ * <p>
+ * Internally the bits are represented in a 1-D array of 32-bit ints. However, each row begins
  * with a new int. This is done intentionally so that we can copy out a row into a BitArray very
- * efficiently.</p>
- *
- * <p>The ordering of bits is row-major. Within each int, the least significant bits are used first,
- * meaning they represent lower x values. This is compatible with BitArray's implementation.</p>
+ * efficiently.
+ * <p>
+ * The ordering of bits is row-major. Within each int, the least significant bits are used first,
+ * meaning they represent lower x values. This is compatible with BitArray's implementation.
  *
  * @author Sean Owen
  * @author [email protected] (Daniel Switkin)
@@ -85,7 +85,7 @@ public BitMatrix(int width, int height) {
     }
 
     /**
-     * <p>Gets the requested bit, where true means black.</p>
+     * Gets the requested bit, where true means black.
      *
      * @param x The horizontal component (i.e. which column)
      * @param y The vertical component (i.e. which row)
@@ -97,7 +97,7 @@ public boolean get(int x, int y) {
     }
 
     /**
-     * <p>Sets the given bit to true.</p>
+     * Sets the given bit to true.
      *
      * @param x The horizontal component (i.e. which column)
      * @param y The vertical component (i.e. which row)
@@ -108,7 +108,7 @@ public void set(int x, int y) {
     }
 
     /**
-     * <p>Flips the given bit.</p>
+     * Flips the given bit.
      *
      * @param x The horizontal component (i.e. which column)
      * @param y The vertical component (i.e. which row)
@@ -129,7 +129,7 @@ public void clear() {
     }
 
     /**
-     * <p>Sets a square region of the bit matrix to true.</p>
+     * Sets a square region of the bit matrix to true.
      *
      * @param left The horizontal position to begin at (inclusive)
      * @param top The vertical position to begin at (inclusive)

barcodes/src/main/java/com/itextpdf/barcodes/qrcode/ErrorCorrectionLevel.java

@@ -44,8 +44,8 @@ This file is part of the iText (R) project.
 package com.itextpdf.barcodes.qrcode;
 
 /**
- * <p>See ISO 18004:2006, 6.5.1. This enum encapsulates the four error correction levels
- * defined by the QR code standard.</p>
+ * See ISO 18004:2006, 6.5.1. This enum encapsulates the four error correction levels
+ * defined by the QR code standard.
  *
  * @author Sean Owen
  */

barcodes/src/main/java/com/itextpdf/barcodes/qrcode/FormatInformation.java

@@ -44,8 +44,8 @@ This file is part of the iText (R) project.
 package com.itextpdf.barcodes.qrcode;
 
 /**
- * <p>Encapsulates a QR Code's format information, including the data mask used and
- * error correction level.</p>
+ * Encapsulates a QR Code's format information, including the data mask used and
+ * error correction level.
  *
  * @author Sean Owen
  * @see ErrorCorrectionLevel

barcodes/src/main/java/com/itextpdf/barcodes/qrcode/GF256.java

@@ -44,12 +44,12 @@ This file is part of the iText (R) project.
 package com.itextpdf.barcodes.qrcode;
 
 /**
- * <p>This class contains utility methods for performing mathematical operations over
- * the Galois Field GF(256). Operations use a given primitive polynomial in calculations.</p>
- *
- * <p>Throughout this package, elements of GF(256) are represented as an <code>int</code>
+ * This class contains utility methods for performing mathematical operations over
+ * the Galois Field GF(256). Operations use a given primitive polynomial in calculations.
+ * <p>
+ * Throughout this package, elements of GF(256) are represented as an <code>int</code>
  * for convenience and speed (but at the cost of memory).
- * Only the bottom 8 bits are really used.</p>
+ * Only the bottom 8 bits are really used.
  *
  * @author Sean Owen
  */

barcodes/src/main/java/com/itextpdf/barcodes/qrcode/GF256Poly.java

@@ -44,11 +44,11 @@ This file is part of the iText (R) project.
 package com.itextpdf.barcodes.qrcode;
 
 /**
- * <p>Represents a polynomial whose coefficients are elements of GF(256).
- * Instances of this class are immutable.</p>
- *
- * <p>Much credit is due to William Rucklidge since portions of this code are an indirect
- * port of his C++ Reed-Solomon implementation.</p>
+ * Represents a polynomial whose coefficients are elements of GF(256).
+ * Instances of this class are immutable.
+ * <p>
+ * Much credit is due to William Rucklidge since portions of this code are an indirect
+ * port of his C++ Reed-Solomon implementation.
  *
  * @author Sean Owen
  */

barcodes/src/main/java/com/itextpdf/barcodes/qrcode/Mode.java

@@ -44,8 +44,8 @@ This file is part of the iText (R) project.
 package com.itextpdf.barcodes.qrcode;
 
 /**
- * <p>See ISO 18004:2006, 6.4.1, Tables 2 and 3. This enum encapsulates the various modes in which
- * data can be encoded to bits in the QR code standard.</p>
+ * See ISO 18004:2006, 6.4.1, Tables 2 and 3. This enum encapsulates the various modes in which
+ * data can be encoded to bits in the QR code standard.
  *
  * @author Sean Owen
  */

barcodes/src/main/java/com/itextpdf/barcodes/qrcode/ReedSolomonEncoder.java

@@ -47,7 +47,7 @@ This file is part of the iText (R) project.
 import java.util.List;
 
 /**
- * <p>Implements Reed-Solomon encoding, as the name implies.</p>
+ * Implements Reed-Solomon encoding, as the name implies.
  *
  * @author Sean Owen
  * @author William Rucklidge

barcodes/src/main/java/com/itextpdf/barcodes/qrcode/ReedSolomonException.java

@@ -44,8 +44,8 @@ This file is part of the iText (R) project.
 package com.itextpdf.barcodes.qrcode;
 
 /**
- * <p>Thrown when an exception occurs during Reed-Solomon decoding, such as when
- * there are too many errors to correct.</p>
+ * Thrown when an exception occurs during Reed-Solomon decoding, such as when
+ * there are too many errors to correct.
  *
  * @author Sean Owen
  */

barcodes/src/main/java/com/itextpdf/barcodes/qrcode/Version.java

@@ -129,7 +129,7 @@ public ECBlocks getECBlocksForLevel(ErrorCorrectionLevel ecLevel) {
     }
 
     /**
-     * <p>Deduces version information purely from QR Code dimensions.</p>
+     * Deduces version information purely from QR Code dimensions.
      *
      * @param dimension dimension in modules
      * @return {@link Version} for a QR Code of that dimension
@@ -231,10 +231,10 @@ BitMatrix buildFunctionPattern() {
     }
 
     /**
-     * <p>Encapsulates a set of error-correction blocks in one symbol version. Most versions will
+     * Encapsulates a set of error-correction blocks in one symbol version. Most versions will
      * use blocks of differing sizes within one version, so, this encapsulates the parameters for
      * each set of blocks. It also holds the number of error-correction codewords per block since it
-     * will be the same across all blocks within one version.</p>
+     * will be the same across all blocks within one version.
      */
     public static final class ECBlocks {
         private final int ecCodewordsPerBlock;
@@ -278,9 +278,9 @@ public ECB[] getECBlocks() {
     }
 
     /**
-     * <p>Encapsualtes the parameters for one error-correction block in one symbol version.
+     * Encapsualtes the parameters for one error-correction block in one symbol version.
      * This includes the number of data codewords, and the number of times a block with these
-     * parameters is used consecutively in the QR code version's format.</p>
+     * parameters is used consecutively in the QR code version's format.
      */
     public static final class ECB {
         private final int count;