Add missing javadocs

DEVSIX-8872

Author: Dmitry Radchuk

src/main/java/com/itextpdf/html2pdf/attach/impl/tags/HTagWorker.java

@@ -27,6 +27,9 @@ This file is part of the iText (R) project.
 import com.itextpdf.layout.IPropertyContainer;
 import com.itextpdf.styledxmlparser.node.IElementNode;
 
+/**
+ * TagWorker class for the {@code h} element.
+ */
 public class HTagWorker extends DivTagWorker {
 
     private String role;

src/main/java/com/itextpdf/html2pdf/attach/impl/tags/PlaceholderTagWorker.java

@@ -32,6 +32,12 @@ This file is part of the iText (R) project.
  */
 public class PlaceholderTagWorker implements ITagWorker {
 
+    /**
+     * Creates a new {@link PlaceholderTagWorker} instance.
+     *
+     * @param element the element
+     * @param context the context
+     */
     public PlaceholderTagWorker(IElementNode element, ProcessorContext context) {
         // Do nothing here
     }

src/main/java/com/itextpdf/html2pdf/attach/util/AccessiblePropHelper.java

@@ -27,12 +27,28 @@ This file is part of the iText (R) project.
 import com.itextpdf.layout.tagging.IAccessibleElement;
 import com.itextpdf.styledxmlparser.node.IElementNode;
 
+/**
+ * Utility class to set lang attribute.
+ */
 public class AccessiblePropHelper {
+
+    /**
+     * Set language attribute in elements accessibility properties if it is not set, does nothing otherwise.
+     *
+     * @param accessibleElement pdf element to set language property on
+     * @param element html element from which lang property will be extracted
+     */
     public static void trySetLangAttribute(IAccessibleElement accessibleElement, IElementNode element) {
         String lang = element.getAttribute(AttributeConstants.LANG);
         trySetLangAttribute(accessibleElement, lang);
     }
 
+    /**
+     * Set language attribute in elements accessibility properties if it is not set, does nothing otherwise.
+     *
+     * @param accessibleElement pdf element to set language property on
+     * @param lang language to set
+     */
     public static void trySetLangAttribute(IAccessibleElement accessibleElement, String lang) {
         if (lang != null) {
             AccessibilityProperties properties = accessibleElement.getAccessibilityProperties();

src/main/java/com/itextpdf/html2pdf/attach/util/ContextMappingHelper.java

@@ -25,8 +25,18 @@ This file is part of the iText (R) project.
 import com.itextpdf.html2pdf.attach.ProcessorContext;
 import com.itextpdf.svg.processors.impl.SvgConverterProperties;
 
+/**
+ * Utility class which helps to map {@link ProcessorContext} properties on {@link SvgConverterProperties}.
+ */
 public class ContextMappingHelper {
 
+    /**
+     * Map {@link ProcessorContext} properties to {@link SvgConverterProperties}.
+     *
+     * @param context {@link ProcessorContext} instance
+     *
+     * @return {@link SvgConverterProperties} filled with necessary data for svg convertion
+     */
     public static SvgConverterProperties mapToSvgConverterProperties(ProcessorContext context){
         SvgConverterProperties svgConverterProperties = new SvgConverterProperties();
         svgConverterProperties.setFontProvider(context.getFontProvider())

src/main/java/com/itextpdf/html2pdf/attach/util/WaitingInlineElementsHelper.java

@@ -110,6 +110,11 @@ public void add(ILeafElement element) {
         waitingLeaves.add(element);
     }
 
+    /**
+     * Adds a block element to the waiting leaves.
+     *
+     * @param element the element
+     */
     public void add(IBlockElement element) {
         waitingLeaves.add(element);
     }

src/main/java/com/itextpdf/html2pdf/attach/wrapelement/TableWrapper.java

@@ -75,9 +75,17 @@ public class TableWrapper implements IWrapElement {
     /** The header lang attribute value. */
     private String headerLang;
 
+    /**
+     * Create new {@link TableWrapper} instance.
+     */
     public TableWrapper() {
     }
 
+    /**
+     * Create new {@link TableWrapper} instance.
+     *
+     * @param isRtl table direction value, true for right to left direction, false for left to right
+     */
     public TableWrapper(boolean isRtl) {
         this.isRtl = isRtl;
     }
@@ -169,14 +177,29 @@ public void addCell(Cell cell) {
         addCellToTable(cell, rows, rowShift);
     }
 
+    /**
+     * Set language attribute of the table.
+     *
+     * @param lang language code string value (e.g en-us)
+     */
     public void setLang(String lang) {
         this.lang = lang;
     }
 
+    /**
+     * Set footer language attribute of the table.
+     *
+     * @param footerLang language code string value (e.g en-us)
+     */
     public void setFooterLang(String footerLang) {
         this.footerLang = footerLang;
     }
 
+    /**
+     * Set header language attribute of the table.
+     *
+     * @param headerLang language code string value (e.g en-us)
+     */
     public void setHeaderLang(String headerLang) {
         this.headerLang = headerLang;
     }

src/main/java/com/itextpdf/html2pdf/css/CssConstants.java

@@ -29,6 +29,10 @@ This file is part of the iText (R) project.
 import java.util.HashSet;
 import java.util.Set;
 
+/**
+ * Class containing possible CSS property keys and values, pseudo-element keys,
+ * units of measurement, and so on, specific for html2pdf module.
+ */
 public class CssConstants extends CommonCssConstants {
 
     /** The Constant AUTO_FIT. */

src/main/java/com/itextpdf/html2pdf/css/apply/util/OutlineApplierUtil.java

@@ -50,6 +50,9 @@ This file is part of the iText (R) project.
 
 import java.util.Map;
 
+/**
+ * Utility class to apply outline properties.
+ */
 public class OutlineApplierUtil {
 
     /**

src/main/java/com/itextpdf/html2pdf/css/apply/util/TextDecorationApplierUtil.java

@@ -31,6 +31,9 @@ This file is part of the iText (R) project.
 import java.util.List;
 import java.util.Set;
 
+/**
+ * Utility class which processes text decoration properties.
+ */
 public final class TextDecorationApplierUtil {
     private static final String IGNORED = "__ignored__";
     private static final SupportedTextDecoration[] SUPPORTED_TEXT_DECORATION_PROPERTIES =
@@ -45,6 +48,16 @@ public final class TextDecorationApplierUtil {
     private TextDecorationApplierUtil() {
     }
 
+    /**
+     * Expand text decoration properties to the element if needed.
+     * <p>
+     * E.g. the following:
+     * {@code text-decoration-line: overline underline; text-decoration-color: pink}
+     * will be translated to:
+     * {@code text-decoration-line: overline underline; text-decoration-color: pink pink}
+     *
+     * @param currentNode the element which decoration properties shall be expanded
+     */
     public static void propagateTextDecorationProperties(IElementNode currentNode) {
         expandTextDecorationProperties(currentNode);
         if (!shouldPropagateTextDecorationProperties(currentNode)) {

src/main/java/com/itextpdf/html2pdf/css/apply/util/TransformationApplierUtil.java

@@ -37,6 +37,9 @@ This file is part of the iText (R) project.
 import static java.lang.Math.sin;
 import static java.lang.Math.tan;
 
+/**
+ * Utility class to apply transform properties.
+ */
 public class TransformationApplierUtil {
 
     /**