Fix javadocs in order in order to make them portable to C# code documentation

Also remove </li> and </dt>, </dd> from javadocs in kernel module. In javadocs it's enough to specify only openning tags and we aim at less cluttered documentation.

DEVSIX-3096

Autoported commit.
Original commit hash: [95035e6c7]
Manual files:
kernel/src/main/java/com/itextpdf/kernel/pdf/PdfDate.java
kernel/src/main/java/com/itextpdf/kernel/xmp/impl/CountOutputStream.java
kernel/src/main/java/com/itextpdf/kernel/xmp/impl/ParseRDF.java

Author: yulian-gaponenko

itext/itext.kernel/itext/kernel/font/PdfFont.cs

@@ -389,8 +389,10 @@ public virtual bool IsSubset() {
         /// </summary>
         /// <remarks>
         /// Indicates if all the glyphs and widths for that particular
-        /// encoding should be included in the document. When set to <CODE>true</CODE>
-        /// only the glyphs used will be included in the font. When set to <CODE>false&lt;/CODE
+        /// encoding should be included in the document. When set to
+        /// <see langword="true"/>
+        /// only the glyphs used will be included in the font. When set to
+        /// <see langword="false"/>
         /// the full font will be included and all subset ranges will be removed.
         /// </remarks>
         /// <param name="subset">new value of property subset</param>

itext/itext.kernel/itext/kernel/geom/AffineTransform.cs

@@ -213,28 +213,28 @@ public AffineTransform(double[] matrix) {
         /// <ul>
         /// <li>
         /// <see cref="TYPE_IDENTITY"/>
-        /// - new basis equals original one and zero translation</li>
+        /// - new basis equals original one and zero translation
         /// <li>
         /// <see cref="TYPE_TRANSLATION"/>
-        /// - translation vector isn't zero</li>
+        /// - translation vector isn't zero
         /// <li>
         /// <see cref="TYPE_UNIFORM_SCALE"/>
-        /// - vectors length of new basis equals</li>
+        /// - vectors length of new basis equals
         /// <li>
         /// <see cref="TYPE_GENERAL_SCALE"/>
-        /// - vectors length of new basis doesn't equal</li>
+        /// - vectors length of new basis doesn't equal
         /// <li>
         /// <see cref="TYPE_FLIP"/>
-        /// - new basis vector orientation differ from original one</li>
+        /// - new basis vector orientation differ from original one
         /// <li>
         /// <see cref="TYPE_QUADRANT_ROTATION"/>
-        /// - new basis is rotated by 90, 180, 270, or 360 degrees</li>
+        /// - new basis is rotated by 90, 180, 270, or 360 degrees
         /// <li>
         /// <see cref="TYPE_GENERAL_ROTATION"/>
-        /// - new basis is rotated by arbitrary angle</li>
+        /// - new basis is rotated by arbitrary angle
         /// <li>
         /// <see cref="TYPE_GENERAL_TRANSFORM"/>
-        /// - transformation can't be inversed</li>
+        /// - transformation can't be inversed
         /// </ul>
         /// </remarks>
         /// <returns>the type of this AffineTransform</returns>

itext/itext.kernel/itext/kernel/pdf/PdfDate.cs

@@ -50,15 +50,17 @@ namespace iText.Kernel.Pdf {
     /// <summary>
     /// <c>PdfDate</c>
     /// is the PDF date object.
-    /// <P>
+    /// <para/>
     /// PDF defines a standard date format. The PDF date format closely follows the format
     /// defined by the international standard ASN.1 (Abstract Syntax Notation One, defined
     /// in CCITT X.208 or ISO/IEC 8824). A date is a
     /// <c>PdfString</c>
     /// of the form:
-    /// <P><BLOCKQUOTE>
+    /// <para/>
+    /// <c>
     /// (D:YYYYMMDDHHmmSSOHH'mm')
-    /// </BLOCKQUOTE><P>
+    /// </c>
+    /// <para/>
     /// See also ISO-320001 7.9.4, "Dates".
     /// </summary>
     /// <seealso cref="PdfString"/>

itext/itext.kernel/itext/kernel/pdf/PdfObject.cs

@@ -516,12 +516,18 @@ protected internal virtual void CopyContent(PdfObject from, PdfDocument document
         /// <summary>
         /// Processes two cases of object copying:
         /// <ol>
-        /// <li>copying to the other document</li>
-        /// <li>cloning inside of the current document</li>
+        /// <li>copying to the other document
+        /// <li>cloning inside of the current document
         /// </ol>
         /// <p>
-        /// This two cases are distinguished by the state of <code>document</code> parameter:
-        /// the second case is processed if <code>document</code> is <code>null</code>.
+        /// This two cases are distinguished by the state of
+        /// <c>document</c>
+        /// parameter:
+        /// the second case is processed if
+        /// <c>document</c>
+        /// is
+        /// <see langword="null"/>
+        /// .
         /// </summary>
         /// <param name="documentTo">if not null: document to copy object to; otherwise indicates that object is to be cloned.
         ///     </param>

itext/itext.kernel/itext/kernel/pdf/PdfString.cs

@@ -66,9 +66,8 @@ namespace iText.Kernel.Pdf {
     /// way to represent characters outside the printable ASCII character set.<br />
     /// This object is described in the 'Portable Document Format Reference Manual
     /// version 1.7' section 3.2.3 (page 53-56).
-    /// <p>
-    /// <see cref="PdfObject"/>
     /// </summary>
+    /// <seealso cref="PdfObject"/>
     public class PdfString : PdfPrimitiveObject {
         protected internal String value;
 

itext/itext.kernel/itext/kernel/pdf/PdfTextArray.cs

@@ -47,19 +47,26 @@ source product.
 using iText.Kernel.Font;
 
 namespace iText.Kernel.Pdf {
-    /// <summary><CODE>PdfTextArray</CODE> defines an array with displacements and <CODE>PdfString</CODE>-objects.
-    ///     </summary>
-    /// <remarks>
-    /// <CODE>PdfTextArray</CODE> defines an array with displacements and <CODE>PdfString</CODE>-objects.
+    /// <summary>
+    /// <see cref="PdfTextArray"/>
+    /// defines an array with displacements and
+    /// <see cref="PdfString"/>
+    /// -objects.
     /// <P>
-    /// A <CODE>PdfTextArray</CODE> is used with the operator <VAR>TJ</VAR> in <CODE>PdfCanvas</CODE>.
-    /// The first object in this array has to be a <CODE>PdfString</CODE>;
+    /// A
+    /// <see cref="PdfTextArray"/>
+    /// is used with the operator TJ in
+    /// <see cref="iText.Kernel.Pdf.Canvas.PdfCanvas"/>
+    /// .
+    /// The first object in this array has to be a
+    /// <see cref="PdfString"/>
+    /// ;
     /// see reference manual version 1.3 section 8.7.5, pages 346-347.
     /// OR
     /// see reference manual version 1.6 section 5.3.2, pages 378-379.
     /// To emit a more efficient array, we consolidate repeated numbers or strings into single array entries.
-    /// "add( 50 ); add( -50 );" will REMOVE the combined zero from the array.
-    /// </remarks>
+    /// For example: "add( 50 ); add( -50 );" will REMOVE the combined zero from the array.
+    /// </summary>
     public class PdfTextArray : PdfArray {
         private float lastNumber = float.NaN;
 

itext/itext.kernel/itext/kernel/pdf/WriterProperties.cs

@@ -190,7 +190,6 @@ public virtual iText.Kernel.Pdf.WriterProperties SetFullCompressionMode(bool ful
         /// <see cref="EncryptionConstants.ALLOW_DEGRADED_PRINTING"/>
         /// .
         /// The permissions can be combined by ORing them.
-        /// <p>
         /// </remarks>
         /// <param name="userPassword">the user password. Can be null or empty</param>
         /// <param name="ownerPassword">the owner password. Can be null or empty</param>
@@ -242,7 +241,6 @@ public virtual iText.Kernel.Pdf.WriterProperties SetStandardEncryption(byte[] us
         /// <see cref="EncryptionConstants.ALLOW_DEGRADED_PRINTING"/>
         /// .
         /// The permissions can be combined by ORing them.
-        /// <p>
         /// </remarks>
         /// <param name="certs">the public certificates to be used for the encryption</param>
         /// <param name="permissions">the user permissions for each of the certificates</param>

itext/itext.kernel/itext/kernel/pdf/annot/BorderStyleUtil.cs

@@ -53,19 +53,19 @@ private BorderStyleUtil() {
         /// <ul>
         /// <li>
         /// <see cref="PdfAnnotation.STYLE_SOLID"/>
-        /// - A solid rectangle surrounding the annotation.</li>
+        /// - A solid rectangle surrounding the annotation.
         /// <li>
         /// <see cref="PdfAnnotation.STYLE_DASHED"/>
-        /// - A dashed rectangle surrounding the annotation.</li>
+        /// - A dashed rectangle surrounding the annotation.
         /// <li>
         /// <see cref="PdfAnnotation.STYLE_BEVELED"/>
-        /// - A simulated embossed rectangle that appears to be raised above the surface of the page.</li>
+        /// - A simulated embossed rectangle that appears to be raised above the surface of the page.
         /// <li>
         /// <see cref="PdfAnnotation.STYLE_INSET"/>
-        /// - A simulated engraved rectangle that appears to be recessed below the surface of the page.</li>
+        /// - A simulated engraved rectangle that appears to be recessed below the surface of the page.
         /// <li>
         /// <see cref="PdfAnnotation.STYLE_UNDERLINE"/>
-        /// - A single line along the bottom of the annotation rectangle.</li>
+        /// - A single line along the bottom of the annotation rectangle.
         /// </ul>
         /// See also ISO-320001, Table 166.
         /// </remarks>

itext/itext.kernel/itext/kernel/pdf/annot/PdfAnnotation.cs

@@ -696,57 +696,47 @@ public virtual iText.Kernel.Pdf.Annot.PdfAnnotation SetFlags(int flags) {
         /// - If set, do not display the annotation if it does not belong to one of the
         /// standard annotation types and no annotation handler is available. If clear, display such unknown annotation
         /// using an appearance stream specified by its appearance dictionary, if any.
-        /// </li>
         /// <li>
         /// <see cref="HIDDEN"/>
         /// - If set, do not display or print the annotation or allow it to interact with
         /// the user, regardless of its annotation type or whether an annotation handler is available.
-        /// </li>
         /// <li>
         /// <see cref="PRINT"/>
         /// - If set, print the annotation when the page is printed. If clear, never print
         /// the annotation, regardless of whether it is displayed on the screen.
-        /// </li>
         /// <li>
         /// <see cref="NO_ZOOM"/>
         /// - If set, do not scale the annotation’s appearance to match the magnification of
         /// the page. The location of the annotation on the page (defined by the upper-left corner of its annotation
         /// rectangle) shall remain fixed, regardless of the page magnification.}
-        /// </li>
         /// <li>
         /// <see cref="NO_ROTATE"/>
         /// - If set, do not rotate the annotation’s appearance to match the rotation
         /// of the page. The upper-left corner of the annotation rectangle shall remain in a fixed location on the page,
         /// regardless of the page rotation.
-        /// </li>
         /// <li>
         /// <see cref="NO_VIEW"/>
         /// - If set, do not display the annotation on the screen or allow it to interact
         /// with the user. The annotation may be printed (depending on the setting of the Print flag) but should be considered
         /// hidden for purposes of on-screen display and user interaction.
-        /// </li>
         /// <li>
         /// <see cref="READ_ONLY"/>
         /// -  If set, do not allow the annotation to interact with the user. The annotation
         /// may be displayed or printed (depending on the settings of the NoView and Print flags) but should not respond to mouse
         /// clicks or change its appearance in response to mouse motions.
-        /// </li>
         /// <li>
         /// <see cref="LOCKED"/>
         /// -  If set, do not allow the annotation to be deleted or its properties
         /// (including position and size) to be modified by the user. However, this flag does not restrict changes to
         /// the annotation’s contents, such as the value of a form field.
-        /// </li>
         /// <li>
         /// <see cref="TOGGLE_NO_VIEW"/>
         /// - If set, invert the interpretation of the NoView flag for certain events.
-        /// </li>
         /// <li>
         /// <see cref="LOCKED_CONTENTS"/>
         /// - If set, do not allow the contents of the annotation to be modified
         /// by the user. This flag does not restrict deletion of the annotation or changes to other annotation properties,
         /// such as position and size.
-        /// </li>
         /// </ul>
         /// </remarks>
         /// <param name="flag">- an integer interpreted as set of one-bit flags which will be enabled for this annotation.
@@ -1149,12 +1139,8 @@ public virtual iText.Kernel.Pdf.Annot.PdfAnnotation SetAppearanceState(PdfName @
             return Put(PdfName.AS, @as);
         }
 
-        /// <summary>
-        /// <p>
-        /// An array specifying the characteristics of the annotation’s border.
-        /// </summary>
+        /// <summary>An array specifying the characteristics of the annotation’s border.</summary>
         /// <remarks>
-        /// <p>
         /// An array specifying the characteristics of the annotation’s border.
         /// The array consists of three numbers defining the horizontal corner radius,
         /// vertical corner radius, and border width, all in default user space units.
@@ -1211,16 +1197,16 @@ public virtual iText.Kernel.Pdf.Annot.PdfAnnotation SetBorder(PdfArray border) {
         /// <summary>
         /// An array of numbers in the range 0.0 to 1.0, representing a colour used for the following purposes:
         /// <ul>
-        /// <li>The background of the annotation’s icon when closed</li>
-        /// <li>The title bar of the annotation’s pop-up window</li>
-        /// <li>The border of a link annotation</li>
+        /// <li>The background of the annotation’s icon when closed
+        /// <li>The title bar of the annotation’s pop-up window
+        /// <li>The border of a link annotation
         /// </ul>
         /// The number of array elements determines the colour space in which the colour shall be defined:
         /// <ul>
-        /// <li>0 - No colour; transparent</li>
-        /// <li>1 - DeviceGray</li>
-        /// <li>3 - DeviceRGB</li>
-        /// <li>4 - DeviceCMYK</li>
+        /// <li>0 - No colour; transparent
+        /// <li>1 - DeviceGray
+        /// <li>3 - DeviceRGB
+        /// <li>4 - DeviceCMYK
         /// </ul>
         /// </summary>
         /// <returns>An array of numbers in the range 0.0 to 1.0, representing an annotation colour.</returns>

itext/itext.kernel/itext/kernel/pdf/annot/PdfCircleAnnotation.cs

@@ -112,19 +112,19 @@ public virtual iText.Kernel.Pdf.Annot.PdfCircleAnnotation SetBorderStyle(PdfDict
         /// <ul>
         /// <li>
         /// <see cref="PdfAnnotation.STYLE_SOLID"/>
-        /// - A solid rectangle surrounding the annotation.</li>
+        /// - A solid rectangle surrounding the annotation.
         /// <li>
         /// <see cref="PdfAnnotation.STYLE_DASHED"/>
-        /// - A dashed rectangle surrounding the annotation.</li>
+        /// - A dashed rectangle surrounding the annotation.
         /// <li>
         /// <see cref="PdfAnnotation.STYLE_BEVELED"/>
-        /// - A simulated embossed rectangle that appears to be raised above the surface of the page.</li>
+        /// - A simulated embossed rectangle that appears to be raised above the surface of the page.
         /// <li>
         /// <see cref="PdfAnnotation.STYLE_INSET"/>
-        /// - A simulated engraved rectangle that appears to be recessed below the surface of the page.</li>
+        /// - A simulated engraved rectangle that appears to be recessed below the surface of the page.
         /// <li>
         /// <see cref="PdfAnnotation.STYLE_UNDERLINE"/>
-        /// - A single line along the bottom of the annotation rectangle.</li>
+        /// - A single line along the bottom of the annotation rectangle.
         /// </ul>
         /// See also ISO-320001, Table 166.
         /// </remarks>