Improve Javadocs of io and styled-xml-parser

Implemented during the third technical debt session

DEVSIX-3096

Author: Kate Ivanova

io/src/main/java/com/itextpdf/io/codec/TIFFField.java

@@ -125,33 +125,46 @@ public class TIFFField implements Comparable<TIFFField>, Serializable {
      * unsigned data type, long is used. The mapping between types is
      * as follows:
      *
-     * <table border=1 summary="TIFFField data">
+     * <table border="1" summary="TIFFField data">
      * <tr>
      * <th> TIFF type </th> <th> Java type </th>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_BYTE</tt></td>      <td><tt>byte</tt></td>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_ASCII</tt></td>     <td><tt>String</tt></td>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_SHORT</tt></td>     <td><tt>char</tt></td>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_LONG</tt></td>      <td><tt>long</tt></td>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_RATIONAL</tt></td>  <td><tt>long[2]</tt></td>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_SBYTE</tt></td>     <td><tt>byte</tt></td>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_UNDEFINED</tt></td> <td><tt>byte</tt></td>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_SSHORT</tt></td>    <td><tt>short</tt></td>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_SLONG</tt></td>     <td><tt>int</tt></td>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_SRATIONAL</tt></td> <td><tt>int[2]</tt></td>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_FLOAT</tt></td>     <td><tt>float</tt></td>
+     * </tr>
      * <tr>
      * <td><tt>TIFF_DOUBLE</tt></td>    <td><tt>double</tt></td>
+     * </tr>
      * </table>
      *
      * @param tag The tag

io/src/main/java/com/itextpdf/io/font/FontRegisterProvider.java

@@ -319,7 +319,7 @@ int registerFontDirectory(String dir) {
      * Register all the fonts in a directory and possibly its subdirectories.
      *
      * @param dir                the directory
-     * @param scanSubdirectories recursively scan subdirectories if <code>true</true>
+     * @param scanSubdirectories recursively scan subdirectories if <code>true</code>
      * @return the number of fonts registered
      */
     int registerFontDirectory(String dir, boolean scanSubdirectories) {

io/src/main/java/com/itextpdf/io/image/JpegImageHelper.java

@@ -389,7 +389,7 @@ private static int getShort(InputStream jpegStream) throws java.io.IOException {
      * Returns a type of marker.
      *
      * @param marker an int
-     * @return a type: <VAR>VALID_MARKER</CODE>, <VAR>UNSUPPORTED_MARKER</VAR> or <VAR>NOPARAM_MARKER</VAR>
+     * @return a type: <VAR>VALID_MARKER</VAR>, <VAR>UNSUPPORTED_MARKER</VAR> or <VAR>NOPARAM_MARKER</VAR>
      */
     private static int marker(int marker) {
         for (int i = 0; i < VALID_MARKERS.length; i++) {

styled-xml-parser/src/main/java/com/itextpdf/styledxmlparser/jsoup/select/Selector.java

@@ -78,13 +78,13 @@ This file is part of the iText (R) project.
  * <tr><td><code>[attr*=valContaining]</code></td><td>elements with an attribute named "attr", and value containing "valContaining"</td><td><code>a[href*=/search/]</code></td></tr>
  * <tr><td><code>[attr~=<em>regex</em>]</code></td><td>elements with an attribute named "attr", and value matching the regular expression</td><td><code>img[src~=(?i)\\.(png|jpe?g)]</code></td></tr>
  * <tr><td></td><td>The above may be combined in any order</td><td><code>div.header[title]</code></td></tr>
- * <tr><td><td colspan="3"><h3>Combinators</h3></td></tr>
+ * <tr><td colspan="3"><h3>Combinators</h3></td></tr>
  * <tr><td><code>E F</code></td><td>an F element descended from an E element</td><td><code>div a</code>, <code>.logo h1</code></td></tr>
  * <tr><td><code>E {@literal >} F</code></td><td>an F direct child of E</td><td><code>ol {@literal >} li</code></td></tr>
  * <tr><td><code>E + F</code></td><td>an F element immediately preceded by sibling E</td><td><code>li + li</code>, <code>div.head + div</code></td></tr>
  * <tr><td><code>E ~ F</code></td><td>an F element preceded by sibling E</td><td><code>h1 ~ p</code></td></tr>
  * <tr><td><code>E, F, G</code></td><td>all matching elements E, F, or G</td><td><code>a[href], div, h3</code></td></tr>
- * <tr><td><td colspan="3"><h3>Pseudo selectors</h3></td></tr>
+ * <tr><td colspan="3"><h3>Pseudo selectors</h3></td></tr>
  * <tr><td><code>:lt(<em>n</em>)</code></td><td>elements whose sibling index is less than <em>n</em></td><td><code>td:lt(3)</code> finds the first 3 cells of each row</td></tr>
  * <tr><td><code>:gt(<em>n</em>)</code></td><td>elements whose sibling index is greater than <em>n</em></td><td><code>td:gt(1)</code> finds cells after skipping the first two</td></tr>
  * <tr><td><code>:eq(<em>n</em>)</code></td><td>elements whose sibling index is equal to <em>n</em></td><td><code>td:eq(0)</code> finds the first cell of each row</td></tr>

styled-xml-parser/src/main/java/com/itextpdf/styledxmlparser/resolver/resource/ResourceResolver.java

@@ -316,7 +316,7 @@ protected PdfXObject createImageByUrl(URL url) throws Exception {
     }
 
     /**
-     * Checks if source is under data URI scheme. (eg data:[<media type>][;base64],<data>)
+     * Checks if source is under data URI scheme. (eg data:[&lt;media type&gt;][;base64],&lt;data&gt;)
      *
      * @param src String to test
      * @return