From e2f80d961c11784a8a7ebf74ae3502c74f9033a3 Mon Sep 17 00:00:00 2001
From: Angelina Pavlovets <angelina.pavlovets@apryse.com>
Date: Tue, 11 Feb 2025 09:34:25 +0000
Subject: [PATCH] Cover public API in SVG module with javadocs

DEVSIX-8873

Autoported commit.
Original commit hash: [ff83ae4f7]
Manual files:
svg/src/sharpenconfig/java/com/itextpdf/svg/SharpenConfigMapping.java
---
 .../impl/SvgTagSvgNodeRendererUnitTest.cs     |  6 ++
 .../impl/SymbolSvgNodeRendererUnitTest.cs     |  6 ++
 .../itext/svg/css/impl/SvgStyleResolver.cs    | 26 +++++++
 .../processors/impl/SvgConverterProperties.cs | 29 +++++++
 .../processors/impl/font/SvgFontProcessor.cs  | 12 ++-
 .../impl/AbstractContainerSvgNodeRenderer.cs  |  1 +
 .../svg/renderers/impl/DefsSvgNodeRenderer.cs |  4 +
 .../renderers/impl/ISvgTextNodeRenderer.cs    |  5 ++
 .../renderers/impl/PolylineSvgNodeRenderer.cs | 14 +++-
 .../renderers/impl/SymbolSvgNodeRenderer.cs   |  4 +
 .../renderers/impl/TextSvgBranchRenderer.cs   | 76 +++++++++++++++++++
 .../impl/TextSvgTSpanBranchRenderer.cs        |  9 +++
 .../svg/renderers/path/IPathShapeMapper.cs    | 11 ++-
 .../renderers/path/impl/AbstractPathShape.cs  | 46 +++++++++++
 .../svg/renderers/path/impl/ClosePath.cs      | 19 ++++-
 .../itext/svg/renderers/path/impl/CurveTo.cs  | 36 ++++++++-
 .../itext/svg/renderers/path/impl/LineTo.cs   | 19 ++++-
 .../itext/svg/renderers/path/impl/MoveTo.cs   | 19 ++++-
 .../renderers/path/impl/QuadraticCurveTo.cs   | 36 ++++++++-
 .../path/impl/QuadraticSmoothCurveTo.cs       | 19 ++++-
 .../svg/renderers/path/impl/SmoothSCurveTo.cs | 19 ++++-
 port-hash                                     |  2 +-
 22 files changed, 406 insertions(+), 12 deletions(-)

diff --git a/itext.tests/itext.svg.tests/itext/svg/renderers/impl/SvgTagSvgNodeRendererUnitTest.cs b/itext.tests/itext.svg.tests/itext/svg/renderers/impl/SvgTagSvgNodeRendererUnitTest.cs
index 359b115b0..ed874b0fa 100644
--- a/itext.tests/itext.svg.tests/itext/svg/renderers/impl/SvgTagSvgNodeRendererUnitTest.cs
+++ b/itext.tests/itext.svg.tests/itext/svg/renderers/impl/SvgTagSvgNodeRendererUnitTest.cs
@@ -64,5 +64,11 @@ public virtual void NoObjectBoundingBoxTest() {
             SvgTagSvgNodeRenderer renderer = new SvgTagSvgNodeRenderer();
             NUnit.Framework.Assert.IsNull(renderer.GetObjectBoundingBox(null));
         }
+
+        [NUnit.Framework.Test]
+        public virtual void CanConstructViewPortTest() {
+            SvgTagSvgNodeRenderer renderer = new SvgTagSvgNodeRenderer();
+            NUnit.Framework.Assert.IsTrue(renderer.CanConstructViewPort());
+        }
     }
 }
diff --git a/itext.tests/itext.svg.tests/itext/svg/renderers/impl/SymbolSvgNodeRendererUnitTest.cs b/itext.tests/itext.svg.tests/itext/svg/renderers/impl/SymbolSvgNodeRendererUnitTest.cs
index 949711507..972d0161d 100644
--- a/itext.tests/itext.svg.tests/itext/svg/renderers/impl/SymbolSvgNodeRendererUnitTest.cs
+++ b/itext.tests/itext.svg.tests/itext/svg/renderers/impl/SymbolSvgNodeRendererUnitTest.cs
@@ -30,5 +30,11 @@ public virtual void NoObjectBoundingBoxTest() {
             SymbolSvgNodeRenderer renderer = new SymbolSvgNodeRenderer();
             NUnit.Framework.Assert.IsNull(renderer.GetObjectBoundingBox(null));
         }
+
+        [NUnit.Framework.Test]
+        public virtual void CanConstructViewPortTest() {
+            SymbolSvgNodeRenderer renderer = new SymbolSvgNodeRenderer();
+            NUnit.Framework.Assert.IsTrue(renderer.CanConstructViewPort());
+        }
     }
 }
diff --git a/itext/itext.svg/itext/svg/css/impl/SvgStyleResolver.cs b/itext/itext.svg/itext/svg/css/impl/SvgStyleResolver.cs
index 19052afb2..214fba28f 100644
--- a/itext/itext.svg/itext/svg/css/impl/SvgStyleResolver.cs
+++ b/itext/itext.svg/itext/svg/css/impl/SvgStyleResolver.cs
@@ -129,6 +129,14 @@ public SvgStyleResolver(INode rootNode, SvgProcessorContext context) {
             CollectFonts();
         }
 
+        /// <summary>Resolves the font size stored inside the current element.</summary>
+        /// <param name="styles">attributes map of the current element</param>
+        /// <param name="cssContext">
+        /// 
+        /// <see cref="iText.Svg.Css.SvgCssContext"/>
+        /// instance in order to resolve relative font size
+        /// </param>
+        /// <param name="parentFontSizeStr">parent font size value</param>
         public static void ResolveFontSizeStyle(IDictionary<String, String> styles, SvgCssContext cssContext, String
              parentFontSizeStr) {
             String elementFontSize = styles.Get(SvgConstants.Attributes.FONT_SIZE);
@@ -166,6 +174,24 @@ public static void ResolveFontSizeStyle(IDictionary<String, String> styles, SvgC
             styles.Put(SvgConstants.Attributes.FONT_SIZE, resolvedFontSize + CommonCssConstants.PT);
         }
 
+        /// <summary>Checks whether element is nested within the passed parent element.</summary>
+        /// <remarks>
+        /// Checks whether element is nested within the passed parent element. Nesting is checked at several levels
+        /// (recursively).
+        /// </remarks>
+        /// <param name="element">
+        /// 
+        /// <see cref="iText.StyledXmlParser.Node.IElementNode"/>
+        /// element to check
+        /// </param>
+        /// <param name="parentElementNameForSearch">expected parent element name</param>
+        /// <returns>
+        /// 
+        /// <see langword="true"/>
+        /// if element is nested within the expected parent,
+        /// <see langword="false"/>
+        /// otherwise
+        /// </returns>
         public static bool IsElementNested(IElementNode element, String parentElementNameForSearch) {
             if (!(element.ParentNode() is IElementNode)) {
                 return false;
diff --git a/itext/itext.svg/itext/svg/processors/impl/SvgConverterProperties.cs b/itext/itext.svg/itext/svg/processors/impl/SvgConverterProperties.cs
index 7d404f579..d75dc0269 100644
--- a/itext/itext.svg/itext/svg/processors/impl/SvgConverterProperties.cs
+++ b/itext/itext.svg/itext/svg/processors/impl/SvgConverterProperties.cs
@@ -96,12 +96,34 @@ public virtual void SetCustomViewport(Rectangle customViewport) {
             this.customViewport = customViewport;
         }
 
+        /// <summary>Sets renderer factory.</summary>
+        /// <param name="rendererFactory">
+        /// 
+        /// <see cref="iText.Svg.Renderers.Factories.ISvgNodeRendererFactory"/>
+        /// to set
+        /// </param>
+        /// <returns>
+        /// this
+        /// <see cref="SvgConverterProperties"/>
+        /// instance
+        /// </returns>
         public virtual iText.Svg.Processors.Impl.SvgConverterProperties SetRendererFactory(ISvgNodeRendererFactory
              rendererFactory) {
             this.rendererFactory = rendererFactory;
             return this;
         }
 
+        /// <summary>Sets font provider.</summary>
+        /// <param name="fontProvider">
+        /// 
+        /// <see cref="iText.Layout.Font.FontProvider"/>
+        /// to set
+        /// </param>
+        /// <returns>
+        /// this
+        /// <see cref="SvgConverterProperties"/>
+        /// instance
+        /// </returns>
         public virtual iText.Svg.Processors.Impl.SvgConverterProperties SetFontProvider(FontProvider fontProvider) {
             this.fontProvider = fontProvider;
             return this;
@@ -116,6 +138,13 @@ public virtual String GetCharset() {
             return charset;
         }
 
+        /// <summary>Sets the character set.</summary>
+        /// <param name="charset">the character set to set</param>
+        /// <returns>
+        /// this
+        /// <see cref="SvgConverterProperties"/>
+        /// instance
+        /// </returns>
         public virtual iText.Svg.Processors.Impl.SvgConverterProperties SetCharset(String charset) {
             this.charset = charset;
             return this;
diff --git a/itext/itext.svg/itext/svg/processors/impl/font/SvgFontProcessor.cs b/itext/itext.svg/itext/svg/processors/impl/font/SvgFontProcessor.cs
index 98ee74944..079ef1a81 100644
--- a/itext/itext.svg/itext/svg/processors/impl/font/SvgFontProcessor.cs
+++ b/itext/itext.svg/itext/svg/processors/impl/font/SvgFontProcessor.cs
@@ -35,8 +35,18 @@ You should have received a copy of the GNU Affero General Public License
 namespace iText.Svg.Processors.Impl.Font {
     /// <summary>Class that processes and add resolved css fonts to the FontProvider</summary>
     public class SvgFontProcessor {
-        private SvgProcessorContext context;
+        private readonly SvgProcessorContext context;
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="SvgFontProcessor"/>
+        /// instance.
+        /// </summary>
+        /// <param name="context">
+        /// 
+        /// <see cref="iText.Svg.Processors.Impl.SvgProcessorContext"/>
+        /// to add resolved fonts to
+        /// </param>
         public SvgFontProcessor(SvgProcessorContext context) {
             this.context = context;
         }
diff --git a/itext/itext.svg/itext/svg/renderers/impl/AbstractContainerSvgNodeRenderer.cs b/itext/itext.svg/itext/svg/renderers/impl/AbstractContainerSvgNodeRenderer.cs
index 4921f45ba..a9f4baf84 100644
--- a/itext/itext.svg/itext/svg/renderers/impl/AbstractContainerSvgNodeRenderer.cs
+++ b/itext/itext.svg/itext/svg/renderers/impl/AbstractContainerSvgNodeRenderer.cs
@@ -27,6 +27,7 @@ You should have received a copy of the GNU Affero General Public License
 using iText.Svg.Utils;
 
 namespace iText.Svg.Renderers.Impl {
+    /// <summary>Abstract class that will be the superclass for any element that instantiates new view port.</summary>
     public abstract class AbstractContainerSvgNodeRenderer : AbstractBranchSvgNodeRenderer {
         public override bool CanConstructViewPort() {
             return true;
diff --git a/itext/itext.svg/itext/svg/renderers/impl/DefsSvgNodeRenderer.cs b/itext/itext.svg/itext/svg/renderers/impl/DefsSvgNodeRenderer.cs
index ee842f326..bfb5083ec 100644
--- a/itext/itext.svg/itext/svg/renderers/impl/DefsSvgNodeRenderer.cs
+++ b/itext/itext.svg/itext/svg/renderers/impl/DefsSvgNodeRenderer.cs
@@ -26,6 +26,10 @@ You should have received a copy of the GNU Affero General Public License
 using iText.Svg.Renderers;
 
 namespace iText.Svg.Renderers.Impl {
+    /// <summary>
+    /// <see cref="iText.Svg.Renderers.ISvgNodeRenderer"/>
+    /// implementation for the &lt;defs&gt; tag.
+    /// </summary>
     public class DefsSvgNodeRenderer : AbstractBranchSvgNodeRenderer, INoDrawSvgNodeRenderer {
         protected internal override void DoDraw(SvgDrawContext context) {
             throw new NotSupportedException(SvgExceptionMessageConstant.DRAW_NO_DRAW);
diff --git a/itext/itext.svg/itext/svg/renderers/impl/ISvgTextNodeRenderer.cs b/itext/itext.svg/itext/svg/renderers/impl/ISvgTextNodeRenderer.cs
index 2b30341f8..97c6ad1a9 100644
--- a/itext/itext.svg/itext/svg/renderers/impl/ISvgTextNodeRenderer.cs
+++ b/itext/itext.svg/itext/svg/renderers/impl/ISvgTextNodeRenderer.cs
@@ -27,7 +27,12 @@ You should have received a copy of the GNU Affero General Public License
 using iText.Svg.Utils;
 
 namespace iText.Svg.Renderers.Impl {
+    /// <summary>Interface for &lt;text&gt; and &lt;tspan&gt; related renderers.</summary>
     public interface ISvgTextNodeRenderer : ISvgNodeRenderer {
+        /// <summary>Gets text content length.</summary>
+        /// <param name="parentFontSize">parent font size</param>
+        /// <param name="font">current font</param>
+        /// <returns>text content length</returns>
         [Obsolete]
         float GetTextContentLength(float parentFontSize, PdfFont font);
 
diff --git a/itext/itext.svg/itext/svg/renderers/impl/PolylineSvgNodeRenderer.cs b/itext/itext.svg/itext/svg/renderers/impl/PolylineSvgNodeRenderer.cs
index b1356aed3..56c9b9a62 100644
--- a/itext/itext.svg/itext/svg/renderers/impl/PolylineSvgNodeRenderer.cs
+++ b/itext/itext.svg/itext/svg/renderers/impl/PolylineSvgNodeRenderer.cs
@@ -37,16 +37,26 @@ namespace iText.Svg.Renderers.Impl {
     /// implementation for the &lt;polyline&gt; tag.
     /// </summary>
     public class PolylineSvgNodeRenderer : AbstractSvgNodeRenderer, IMarkerCapable {
-        /// <summary>orientation vector which is used for marker angle calculation.</summary>
+        /// <summary>Orientation vector which is used for marker angle calculation.</summary>
         private Vector previousOrientationVector = new Vector(1, 0, 0);
 
         /// <summary>
         /// A List of
         /// <see cref="iText.Kernel.Geom.Point"/>
-        /// objects representing the path to be drawn by the polyline tag
+        /// objects representing the path to be drawn by the polyline tag.
         /// </summary>
         protected internal IList<Point> points = new List<Point>();
 
+        /// <summary>
+        /// Returns a list of
+        /// <see cref="iText.Kernel.Geom.Point"/>
+        /// objects representing the path to be drawn by the polyline tag.
+        /// </summary>
+        /// <returns>
+        /// a list of
+        /// <see cref="iText.Kernel.Geom.Point"/>
+        /// objects
+        /// </returns>
         protected internal virtual IList<Point> GetPoints() {
             return this.points;
         }
diff --git a/itext/itext.svg/itext/svg/renderers/impl/SymbolSvgNodeRenderer.cs b/itext/itext.svg/itext/svg/renderers/impl/SymbolSvgNodeRenderer.cs
index 68f814a75..0d185196c 100644
--- a/itext/itext.svg/itext/svg/renderers/impl/SymbolSvgNodeRenderer.cs
+++ b/itext/itext.svg/itext/svg/renderers/impl/SymbolSvgNodeRenderer.cs
@@ -24,6 +24,10 @@ You should have received a copy of the GNU Affero General Public License
 using iText.Svg.Renderers;
 
 namespace iText.Svg.Renderers.Impl {
+    /// <summary>
+    /// <see cref="iText.Svg.Renderers.ISvgNodeRenderer"/>
+    /// implementation for the &lt;symbol&gt; tag.
+    /// </summary>
     public class SymbolSvgNodeRenderer : AbstractContainerSvgNodeRenderer, INoDrawSvgNodeRenderer {
         public override ISvgNodeRenderer CreateDeepCopy() {
             SymbolSvgNodeRenderer copy = new SymbolSvgNodeRenderer();
diff --git a/itext/itext.svg/itext/svg/renderers/impl/TextSvgBranchRenderer.cs b/itext/itext.svg/itext/svg/renderers/impl/TextSvgBranchRenderer.cs
index 8f8ac231a..5f4dec8e3 100644
--- a/itext/itext.svg/itext/svg/renderers/impl/TextSvgBranchRenderer.cs
+++ b/itext/itext.svg/itext/svg/renderers/impl/TextSvgBranchRenderer.cs
@@ -71,6 +71,11 @@ public class TextSvgBranchRenderer : AbstractSvgNodeRenderer, ISvgTextNodeRender
 
         private bool whiteSpaceProcessed = false;
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="TextSvgBranchRenderer"/>
+        /// instance.
+        /// </summary>
         public TextSvgBranchRenderer() {
             performRootTransformations = true;
             moveResolved = false;
@@ -90,6 +95,16 @@ internal virtual void FillCopy(iText.Svg.Renderers.Impl.TextSvgBranchRenderer co
         }
 //\endcond
 
+        /// <summary>
+        /// Adds a child to the current
+        /// <see cref="TextSvgBranchRenderer"/>
+        /// renderer.
+        /// </summary>
+        /// <param name="child">
+        /// 
+        /// <see cref="ISvgTextNodeRenderer"/>
+        /// child to add
+        /// </param>
         public void AddChild(ISvgTextNodeRenderer child) {
             // Final method, in order to disallow adding null
             if (child != null) {
@@ -97,6 +112,16 @@ public void AddChild(ISvgTextNodeRenderer child) {
             }
         }
 
+        /// <summary>
+        /// Retrieves a list of all children of the current
+        /// <see cref="TextSvgBranchRenderer"/>
+        /// renderer.
+        /// </summary>
+        /// <returns>
+        /// a list of
+        /// <see cref="ISvgTextNodeRenderer"/>
+        /// children
+        /// </returns>
         public IList<ISvgTextNodeRenderer> GetChildren() {
             // Final method, in order to disallow modifying the List
             return JavaCollectionsUtil.UnmodifiableList(children);
@@ -113,6 +138,18 @@ public virtual float[] GetRelativeTranslation() {
             return GetRelativeTranslation(new SvgDrawContext(null, null));
         }
 
+        /// <summary>Gets relative translation of the current &lt;text&gt; or &lt;tspan&gt; element.</summary>
+        /// <param name="context">
+        /// current
+        /// <see cref="iText.Svg.Renderers.SvgDrawContext"/>
+        /// </param>
+        /// <returns>
+        /// float array that contains relative
+        /// <c>dx</c>
+        /// and
+        /// <c>dy</c>
+        /// translations
+        /// </returns>
         public virtual float[] GetRelativeTranslation(SvgDrawContext context) {
             if (!moveResolved) {
                 ResolveRelativeTextMove(context);
@@ -125,6 +162,18 @@ public virtual bool ContainsRelativeMove() {
             return ContainsRelativeMove(new SvgDrawContext(null, null));
         }
 
+        /// <summary>Checks whether current &lt;text&gt; or &lt;tspan&gt; element contains relative position change.</summary>
+        /// <param name="context">
+        /// current
+        /// <see cref="iText.Svg.Renderers.SvgDrawContext"/>
+        /// </param>
+        /// <returns>
+        /// 
+        /// <see langword="true"/>
+        /// is current element contains relative position,
+        /// <see langword="false"/>
+        /// otherwise
+        /// </returns>
         public virtual bool ContainsRelativeMove(SvgDrawContext context) {
             if (!moveResolved) {
                 ResolveRelativeTextMove(context);
@@ -138,6 +187,19 @@ public virtual bool ContainsAbsolutePositionChange() {
             return ContainsAbsolutePositionChange(new SvgDrawContext(null, null));
         }
 
+        /// <summary>Checks whether current &lt;text&gt; or &lt;tspan&gt; element contains absolute position attributes.
+        ///     </summary>
+        /// <param name="context">
+        /// current
+        /// <see cref="iText.Svg.Renderers.SvgDrawContext"/>
+        /// </param>
+        /// <returns>
+        /// 
+        /// <see langword="true"/>
+        /// is current element contains absolute position,
+        /// <see langword="false"/>
+        /// otherwise
+        /// </returns>
         public virtual bool ContainsAbsolutePositionChange(SvgDrawContext context) {
             if (!posResolved) {
                 ResolveAbsoluteTextPosition(context);
@@ -149,6 +211,19 @@ public virtual float[][] GetAbsolutePositionChanges() {
             return GetAbsolutePositionChanges(new SvgDrawContext(null, null));
         }
 
+        /// <summary>Gets absolute position of the current &lt;text&gt; or &lt;tspan&gt; element.</summary>
+        /// <param name="context">
+        /// current
+        /// <see cref="iText.Svg.Renderers.SvgDrawContext"/>
+        /// </param>
+        /// <returns>
+        /// float array that contains absolute
+        /// <c>x</c>
+        /// and
+        /// <c>y</c>
+        /// positions as either single item arrays
+        /// or null if attribute is not present
+        /// </returns>
         public virtual float[][] GetAbsolutePositionChanges(SvgDrawContext context) {
             if (!posResolved) {
                 ResolveAbsoluteTextPosition(context);
@@ -156,6 +231,7 @@ public virtual float[][] GetAbsolutePositionChanges(SvgDrawContext context) {
             return new float[][] { xPos, yPos };
         }
 
+        /// <summary>Marks white-space property as processed.</summary>
         public virtual void MarkWhiteSpaceProcessed() {
             whiteSpaceProcessed = true;
         }
diff --git a/itext/itext.svg/itext/svg/renderers/impl/TextSvgTSpanBranchRenderer.cs b/itext/itext.svg/itext/svg/renderers/impl/TextSvgTSpanBranchRenderer.cs
index e1146c170..c6d60d0b5 100644
--- a/itext/itext.svg/itext/svg/renderers/impl/TextSvgTSpanBranchRenderer.cs
+++ b/itext/itext.svg/itext/svg/renderers/impl/TextSvgTSpanBranchRenderer.cs
@@ -23,7 +23,16 @@ You should have received a copy of the GNU Affero General Public License
 using iText.Svg.Renderers;
 
 namespace iText.Svg.Renderers.Impl {
+    /// <summary>
+    /// <see cref="iText.Svg.Renderers.ISvgNodeRenderer"/>
+    /// implementation for the &lt;tspan&gt; tag.
+    /// </summary>
     public class TextSvgTSpanBranchRenderer : TextSvgBranchRenderer {
+        /// <summary>
+        /// Creates new
+        /// <see cref="TextSvgTSpanBranchRenderer"/>
+        /// instance.
+        /// </summary>
         public TextSvgTSpanBranchRenderer() {
             this.performRootTransformations = false;
         }
diff --git a/itext/itext.svg/itext/svg/renderers/path/IPathShapeMapper.cs b/itext/itext.svg/itext/svg/renderers/path/IPathShapeMapper.cs
index af93715a7..9965d85c9 100644
--- a/itext/itext.svg/itext/svg/renderers/path/IPathShapeMapper.cs
+++ b/itext/itext.svg/itext/svg/renderers/path/IPathShapeMapper.cs
@@ -33,12 +33,21 @@ public interface IPathShapeMapper {
         /// <returns>
         /// a
         /// <see cref="System.Collections.IDictionary{K, V}"/>
-        /// with Strings as keys and {link @
+        /// with Strings as keys and
         /// <see cref="IPathShape"/>
         /// implementations as values
         /// </returns>
         IDictionary<String, IPathShape> GetMapping();
 
+        /// <summary>
+        /// Provides a mapping of SVG path element's path-data instruction name to the appropriate number of arguments
+        /// for a path command, based on this passed SVG path data instruction tag.
+        /// </summary>
+        /// <returns>
+        /// a
+        /// <see cref="System.Collections.IDictionary{K, V}"/>
+        /// with Strings as keys and Integers as values
+        /// </returns>
         IDictionary<String, int?> GetArgumentCount();
     }
 }
diff --git a/itext/itext.svg/itext/svg/renderers/path/impl/AbstractPathShape.cs b/itext/itext.svg/itext/svg/renderers/path/impl/AbstractPathShape.cs
index 9bfadf237..921869776 100644
--- a/itext/itext.svg/itext/svg/renderers/path/impl/AbstractPathShape.cs
+++ b/itext/itext.svg/itext/svg/renderers/path/impl/AbstractPathShape.cs
@@ -50,14 +50,36 @@ public abstract class AbstractPathShape : IPathShape {
 
         protected internal SvgDrawContext context;
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="AbstractPathShape"/>
+        /// instance.
+        /// </summary>
         public AbstractPathShape()
             : this(false) {
         }
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="AbstractPathShape"/>
+        /// instance.
+        /// </summary>
+        /// <param name="relative">boolean defining whether this is a relative operator</param>
         public AbstractPathShape(bool relative)
             : this(relative, new DefaultOperatorConverter()) {
         }
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="AbstractPathShape"/>
+        /// instance.
+        /// </summary>
+        /// <param name="relative">boolean defining whether this is a relative operator</param>
+        /// <param name="copier">
+        /// 
+        /// <see cref="IOperatorConverter"/>
+        /// copier for converting relative coordinates to absolute coordinates
+        /// </param>
         public AbstractPathShape(bool relative, IOperatorConverter copier) {
             this.relative = relative;
             this.copier = copier;
@@ -67,6 +89,30 @@ public virtual bool IsRelative() {
             return this.relative;
         }
 
+        /// <summary>
+        /// Creates
+        /// <see cref="iText.Kernel.Geom.Point"/>
+        /// based on provided
+        /// <c>x</c>
+        /// and
+        /// <c>y</c>
+        /// coordinates.
+        /// </summary>
+        /// <param name="coordX">
+        /// 
+        /// <c>x</c>
+        /// coordinate of the point
+        /// </param>
+        /// <param name="coordY">
+        /// 
+        /// <c>y</c>
+        /// coordinate of the point
+        /// </param>
+        /// <returns>
+        /// created
+        /// <see cref="iText.Kernel.Geom.Point"/>
+        /// instance
+        /// </returns>
         protected internal virtual Point CreatePoint(String coordX, String coordY) {
             return new Point((double)CssDimensionParsingUtils.ParseDouble(coordX), (double)CssDimensionParsingUtils.ParseDouble
                 (coordY));
diff --git a/itext/itext.svg/itext/svg/renderers/path/impl/ClosePath.cs b/itext/itext.svg/itext/svg/renderers/path/impl/ClosePath.cs
index 8d49c818b..e59f06f86 100644
--- a/itext/itext.svg/itext/svg/renderers/path/impl/ClosePath.cs
+++ b/itext/itext.svg/itext/svg/renderers/path/impl/ClosePath.cs
@@ -21,16 +21,33 @@ You should have received a copy of the GNU Affero General Public License
 along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 namespace iText.Svg.Renderers.Path.Impl {
-    /// <summary>Implements closePath(Z) attribute of SVG's path element</summary>
+    /// <summary>Implements closePath(Z) attribute of SVG's path element.</summary>
     public class ClosePath : LineTo {
 //\cond DO_NOT_DOCUMENT
         internal const int ARGUMENT_SIZE = 0;
 //\endcond
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="ClosePath"/>
+        /// instance.
+        /// </summary>
         public ClosePath()
             : this(false) {
         }
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="ClosePath"/>
+        /// instance.
+        /// </summary>
+        /// <param name="relative">
+        /// 
+        /// <see langword="true"/>
+        /// in case it is a relative operator,
+        /// <see langword="false"/>
+        /// if it is an absolute operator
+        /// </param>
         public ClosePath(bool relative)
             : base(relative) {
         }
diff --git a/itext/itext.svg/itext/svg/renderers/path/impl/CurveTo.cs b/itext/itext.svg/itext/svg/renderers/path/impl/CurveTo.cs
index 86118446e..5a8319bcf 100644
--- a/itext/itext.svg/itext/svg/renderers/path/impl/CurveTo.cs
+++ b/itext/itext.svg/itext/svg/renderers/path/impl/CurveTo.cs
@@ -28,7 +28,7 @@ You should have received a copy of the GNU Affero General Public License
 using iText.Svg.Exceptions;
 
 namespace iText.Svg.Renderers.Path.Impl {
-    /// <summary>Implements curveTo(C) attribute of SVG's path element</summary>
+    /// <summary>Implements curveTo(C) attribute of SVG's path element.</summary>
     public class CurveTo : AbstractPathShape, IControlPointCurve {
 //\cond DO_NOT_DOCUMENT
         internal const int ARGUMENT_SIZE = 6;
@@ -36,14 +36,48 @@ public class CurveTo : AbstractPathShape, IControlPointCurve {
 
         private const double ZERO_EPSILON = 1e-12;
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="CurveTo"/>
+        /// instance.
+        /// </summary>
         public CurveTo()
             : this(false) {
         }
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="CurveTo"/>
+        /// instance.
+        /// </summary>
+        /// <param name="relative">
+        /// 
+        /// <see langword="true"/>
+        /// in case it is a relative operator,
+        /// <see langword="false"/>
+        /// if it is an absolute operator
+        /// </param>
         public CurveTo(bool relative)
             : this(relative, new DefaultOperatorConverter()) {
         }
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="CurveTo"/>
+        /// instance.
+        /// </summary>
+        /// <param name="relative">
+        /// 
+        /// <see langword="true"/>
+        /// in case it is a relative operator,
+        /// <see langword="false"/>
+        /// if it is an absolute operator
+        /// </param>
+        /// <param name="copier">
+        /// 
+        /// <see cref="IOperatorConverter"/>
+        /// copier for converting relative coordinates to absolute coordinates
+        /// </param>
         public CurveTo(bool relative, IOperatorConverter copier)
             : base(relative, copier) {
         }
diff --git a/itext/itext.svg/itext/svg/renderers/path/impl/LineTo.cs b/itext/itext.svg/itext/svg/renderers/path/impl/LineTo.cs
index f3261e073..8bdb6804b 100644
--- a/itext/itext.svg/itext/svg/renderers/path/impl/LineTo.cs
+++ b/itext/itext.svg/itext/svg/renderers/path/impl/LineTo.cs
@@ -26,16 +26,33 @@ You should have received a copy of the GNU Affero General Public License
 using iText.Svg.Exceptions;
 
 namespace iText.Svg.Renderers.Path.Impl {
-    /// <summary>Implements lineTo(L) attribute of SVG's path element</summary>
+    /// <summary>Implements lineTo(L) attribute of SVG's path element.</summary>
     public class LineTo : AbstractPathShape {
 //\cond DO_NOT_DOCUMENT
         internal const int ARGUMENT_SIZE = 2;
 //\endcond
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="LineTo"/>
+        /// instance.
+        /// </summary>
         public LineTo()
             : this(false) {
         }
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="LineTo"/>
+        /// instance.
+        /// </summary>
+        /// <param name="relative">
+        /// 
+        /// <see langword="true"/>
+        /// in case it is a relative operator,
+        /// <see langword="false"/>
+        /// if it is an absolute operator
+        /// </param>
         public LineTo(bool relative)
             : base(relative) {
         }
diff --git a/itext/itext.svg/itext/svg/renderers/path/impl/MoveTo.cs b/itext/itext.svg/itext/svg/renderers/path/impl/MoveTo.cs
index 96f9aaa6d..96a4ed3ee 100644
--- a/itext/itext.svg/itext/svg/renderers/path/impl/MoveTo.cs
+++ b/itext/itext.svg/itext/svg/renderers/path/impl/MoveTo.cs
@@ -26,16 +26,33 @@ You should have received a copy of the GNU Affero General Public License
 using iText.Svg.Exceptions;
 
 namespace iText.Svg.Renderers.Path.Impl {
-    /// <summary>Implements moveTo(M) attribute of SVG's path element</summary>
+    /// <summary>Implements moveTo(M) attribute of SVG's path element.</summary>
     public class MoveTo : AbstractPathShape {
 //\cond DO_NOT_DOCUMENT
         internal const int ARGUMENT_SIZE = 2;
 //\endcond
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="MoveTo"/>
+        /// instance.
+        /// </summary>
         public MoveTo()
             : this(false) {
         }
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="MoveTo"/>
+        /// instance.
+        /// </summary>
+        /// <param name="relative">
+        /// 
+        /// <see langword="true"/>
+        /// in case it is a relative operator,
+        /// <see langword="false"/>
+        /// if it is an absolute operator
+        /// </param>
         public MoveTo(bool relative)
             : base(relative) {
         }
diff --git a/itext/itext.svg/itext/svg/renderers/path/impl/QuadraticCurveTo.cs b/itext/itext.svg/itext/svg/renderers/path/impl/QuadraticCurveTo.cs
index bba158921..9deba6617 100644
--- a/itext/itext.svg/itext/svg/renderers/path/impl/QuadraticCurveTo.cs
+++ b/itext/itext.svg/itext/svg/renderers/path/impl/QuadraticCurveTo.cs
@@ -28,20 +28,54 @@ You should have received a copy of the GNU Affero General Public License
 using iText.Svg.Exceptions;
 
 namespace iText.Svg.Renderers.Path.Impl {
-    /// <summary>Implements quadratic Bezier curveTo(Q) attribute of SVG's path element</summary>
+    /// <summary>Implements quadratic Bezier curveTo(Q) attribute of SVG's path element.</summary>
     public class QuadraticCurveTo : AbstractPathShape, IControlPointCurve {
 //\cond DO_NOT_DOCUMENT
         internal const int ARGUMENT_SIZE = 4;
 //\endcond
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="QuadraticCurveTo"/>
+        /// instance.
+        /// </summary>
         public QuadraticCurveTo()
             : this(false) {
         }
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="QuadraticCurveTo"/>
+        /// instance.
+        /// </summary>
+        /// <param name="relative">
+        /// 
+        /// <see langword="true"/>
+        /// in case it is a relative operator,
+        /// <see langword="false"/>
+        /// if it is an absolute operator
+        /// </param>
         public QuadraticCurveTo(bool relative)
             : this(relative, new DefaultOperatorConverter()) {
         }
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="QuadraticCurveTo"/>
+        /// instance.
+        /// </summary>
+        /// <param name="relative">
+        /// 
+        /// <see langword="true"/>
+        /// in case it is a relative operator,
+        /// <see langword="false"/>
+        /// if it is an absolute operator
+        /// </param>
+        /// <param name="copier">
+        /// 
+        /// <see cref="IOperatorConverter"/>
+        /// copier for converting relative coordinates to absolute coordinates
+        /// </param>
         public QuadraticCurveTo(bool relative, IOperatorConverter copier)
             : base(relative, copier) {
         }
diff --git a/itext/itext.svg/itext/svg/renderers/path/impl/QuadraticSmoothCurveTo.cs b/itext/itext.svg/itext/svg/renderers/path/impl/QuadraticSmoothCurveTo.cs
index d68ca1dc0..e98f61d2f 100644
--- a/itext/itext.svg/itext/svg/renderers/path/impl/QuadraticSmoothCurveTo.cs
+++ b/itext/itext.svg/itext/svg/renderers/path/impl/QuadraticSmoothCurveTo.cs
@@ -21,16 +21,33 @@ You should have received a copy of the GNU Affero General Public License
 along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 namespace iText.Svg.Renderers.Path.Impl {
-    /// <summary>Implements shorthand/smooth quadraticCurveTo (T) attribute of SVG's path element</summary>
+    /// <summary>Implements shorthand/smooth quadraticCurveTo (T) attribute of SVG's path element.</summary>
     public class QuadraticSmoothCurveTo : QuadraticCurveTo {
 //\cond DO_NOT_DOCUMENT
         internal const int ARGUMENT_SIZE = 2;
 //\endcond
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="QuadraticSmoothCurveTo"/>
+        /// instance.
+        /// </summary>
         public QuadraticSmoothCurveTo()
             : this(false) {
         }
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="QuadraticSmoothCurveTo"/>
+        /// instance.
+        /// </summary>
+        /// <param name="relative">
+        /// 
+        /// <see langword="true"/>
+        /// in case it is a relative operator,
+        /// <see langword="false"/>
+        /// if it is an absolute operator
+        /// </param>
         public QuadraticSmoothCurveTo(bool relative)
             : base(relative, new SmoothOperatorConverter()) {
         }
diff --git a/itext/itext.svg/itext/svg/renderers/path/impl/SmoothSCurveTo.cs b/itext/itext.svg/itext/svg/renderers/path/impl/SmoothSCurveTo.cs
index 0c2f45f90..708d240aa 100644
--- a/itext/itext.svg/itext/svg/renderers/path/impl/SmoothSCurveTo.cs
+++ b/itext/itext.svg/itext/svg/renderers/path/impl/SmoothSCurveTo.cs
@@ -21,16 +21,33 @@ You should have received a copy of the GNU Affero General Public License
 along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 namespace iText.Svg.Renderers.Path.Impl {
-    /// <summary>Implements shorthand/smooth curveTo (S) attribute of SVG's path element</summary>
+    /// <summary>Implements shorthand/smooth curveTo (S) attribute of SVG's path element.</summary>
     public class SmoothSCurveTo : CurveTo {
 //\cond DO_NOT_DOCUMENT
         internal const int ARGUMENT_SIZE = 4;
 //\endcond
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="SmoothSCurveTo"/>
+        /// instance.
+        /// </summary>
         public SmoothSCurveTo()
             : this(false) {
         }
 
+        /// <summary>
+        /// Creates new
+        /// <see cref="SmoothSCurveTo"/>
+        /// instance.
+        /// </summary>
+        /// <param name="relative">
+        /// 
+        /// <see langword="true"/>
+        /// in case it is a relative operator,
+        /// <see langword="false"/>
+        /// if it is an absolute operator
+        /// </param>
         public SmoothSCurveTo(bool relative)
             : base(relative, new SmoothOperatorConverter()) {
         }
diff --git a/port-hash b/port-hash
index 198d8826a..ebdf73272 100644
--- a/port-hash
+++ b/port-hash
@@ -1 +1 @@
-ec4929e366ec4e87fe7696f7a5fb5ed0d64d5ed7
+ff83ae4f7d0f91c1aef18b34b918be26e6751d97