Documentation and binary compatibility loose ends

DEVSIX-2864

Autoported commit.
Original commit hash: [70c08bd6a]

Author: Samuel Huylebroeck

itext/itext.kernel/itext/kernel/pdf/canvas/PdfCanvas.cs

@@ -1111,8 +1111,7 @@ public virtual iText.Kernel.Pdf.Canvas.PdfCanvas ClosePathFillStroke() {
         [System.ObsoleteAttribute(@"in favour of endPath(), which does exactly the same thing but is better named"
             )]
         public virtual iText.Kernel.Pdf.Canvas.PdfCanvas NewPath() {
-            contentStream.GetOutputStream().WriteBytes(n);
-            return this;
+            return this.EndPath();
         }
 
         /// <summary>Ends the path without filling or stroking it.</summary>

itext/itext.layout/itext/layout/borders/Border.cs

@@ -672,11 +672,11 @@ protected internal virtual void DrawDiscontinuousBorders(PdfCanvas canvas, Recta
             canvas.Stroke().RestoreState();
         }
 
-        /// <summary>Calculate adjusted starting points for non-continuous borders, given two opposing points (A and B) that define the bounding rectangle
+        /// <summary>Calculate adjusted starting points for discontinuous borders, given two opposing points (A and B) that define the bounding rectangle
         ///     </summary>
-        /// <param name="x1">x-ordinate of point A</param>
+        /// <param name="x1">x-coordinate of point A</param>
         /// <param name="y1">y-ordinate of point A</param>
-        /// <param name="x2">x-ordinate of point B</param>
+        /// <param name="x2">x-coordinate of point B</param>
         /// <param name="y2">y-ordinate of point B</param>
         /// <param name="defaultSide">default side of the border used to determine the side given by points A and B</param>
         /// <returns>float[] containing the adjusted starting points in the form {x1,y1,x2,y2}</returns>

itext/itext.layout/itext/layout/borders/DashedBorder.cs

@@ -143,5 +143,17 @@ public override void Draw(PdfCanvas canvas, float x1, float y1, float x2, float
             DrawDiscontinuousBorders(canvas, boundingRectangle, horizontalRadii, verticalRadii, defaultSide, borderWidthBefore
                 , borderWidthAfter);
         }
+
+        /// <summary>Adjusts the size of the gap between dots</summary>
+        /// <param name="distance">
+        /// the
+        /// <see cref="Border">border</see>
+        /// length
+        /// </param>
+        /// <param name="initialGap">the initial size of the gap</param>
+        /// <returns>the adjusted size of the gap</returns>
+        protected internal override float GetDotsGap(double distance, float initialGap) {
+            return base.GetDotsGap(distance, initialGap);
+        }
     }
 }

itext/itext.layout/itext/layout/borders/DottedBorder.cs

@@ -146,5 +146,17 @@ public override void DrawCellBorder(PdfCanvas canvas, float x1, float y1, float
             canvas.SetLineDash(width, adjustedGap, width + adjustedGap / 2).MoveTo(x1, y1).LineTo(x2, y2).Stroke().RestoreState
                 ();
         }
+
+        /// <summary>Adjusts the size of the gap between dots</summary>
+        /// <param name="distance">
+        /// the
+        /// <see cref="Border">border</see>
+        /// length
+        /// </param>
+        /// <param name="initialGap">the initial size of the gap</param>
+        /// <returns>the adjusted size of the gap</returns>
+        protected internal override float GetDotsGap(double distance, float initialGap) {
+            return base.GetDotsGap(distance, initialGap);
+        }
     }
 }

itext/itext.layout/itext/layout/borders/RoundDotsBorder.cs

@@ -145,5 +145,17 @@ public override void Draw(PdfCanvas canvas, float x1, float y1, float x2, float
             DrawDiscontinuousBorders(canvas, boundingRectangle, horizontalRadii, verticalRadii, defaultSide, borderWidthBefore
                 , borderWidthAfter);
         }
+
+        /// <summary>Adjusts the size of the gap between dots</summary>
+        /// <param name="distance">
+        /// the
+        /// <see cref="Border">border</see>
+        /// length
+        /// </param>
+        /// <param name="initialGap">the initial size of the gap</param>
+        /// <returns>the adjusted size of the gap</returns>
+        protected internal override float GetDotsGap(double distance, float initialGap) {
+            return base.GetDotsGap(distance, initialGap);
+        }
     }
 }

port-hash

@@ -1 +1 @@
-2373c33e9f6c5324ba0c1ad3171fc1acf92a7e4d
+70c08bd6ad90e2c19c70c35dab017d76e1b4a3dd