More doc improvements

Author: mattleibow

SkiaSharpAPI/SkiaSharp/SKAbstractManagedStream.xml

@@ -218,7 +218,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Implemented by derived <see cref="T:SkiaSharp.SKAbstractManagedStream" /> types to get the current position in the stream</summary>
+        <summary>Implemented by derived <see cref="T:SkiaSharp.SKAbstractManagedStream" /> types to get the current position in the stream.</summary>
         <returns>Returns the current position in the stream.</returns>
         <remarks />
       </Docs>

SkiaSharpAPI/SkiaSharp/SKCanvas.xml

@@ -397,7 +397,7 @@ using (var surface = SKSurface.Create(info)) {
       </Parameters>
       <Docs>
         <param name="path">The path to combine with the current clip.</param>
-        <param name="operation">The clip operator to apply to the current clip</param>
+        <param name="operation">The clip operator to apply to the current clip.</param>
         <param name="antialias">
           <see langword="true" /> to antialias the clip; otherwise, <see langword="false" />.</param>
         <summary>Modify the current clip with the specified path.</summary>
@@ -481,7 +481,7 @@ using (var surface = SKSurface.Create(info)) {
       </Parameters>
       <Docs>
         <param name="rect">The rounded rectangle to combine with the current clip.</param>
-        <param name="operation">The clip operator to apply to the current clip</param>
+        <param name="operation">The clip operator to apply to the current clip.</param>
         <param name="antialias">
           <see langword="true" /> to antialias the clip; otherwise, <see langword="false" />.</param>
         <summary>Modify the current clip with the specified rounded rectangle.</summary>
@@ -2596,8 +2596,8 @@ contours intersect each other (think <xref:SkiaSharp.SKBlendMode.Xor>).
       </Parameters>
       <Docs>
         <param name="buffer">The pointer to a region holding UTF-8 encoded text to draw.</param>
-        <param name="length">The number of bytes to read from the <paramref name="buffer." /></param>
-        <param name="points">The positions for each glyph in the <paramref name="buffer." /></param>
+        <param name="length">The number of bytes to read from the <paramref name="buffer" /></param>
+        <param name="points">The positions for each glyph in the <paramref name="buffer" /></param>
         <param name="paint">The paint to use when drawing the text.</param>
         <summary>Draws text from a UTF-8 buffer at specified locations on the canvas.</summary>
         <remarks />
@@ -3111,7 +3111,7 @@ using (var surface = SKSurface.Create(info)) {
       </Parameters>
       <Docs>
         <param name="buffer">The pointer to a region holding UTF-8 encoded text to draw.</param>
-        <param name="length">The number of bytes to read from the <paramref name="buffer." /></param>
+        <param name="length">The number of bytes to read from the <paramref name="buffer" /></param>
         <param name="p">The coordinates of the origin of the text being drawn.</param>
         <param name="paint">The paint to use when drawing the text.</param>
         <summary>Draws text encoded in a UTF-8 buffer on the canvas at the specified coordinates.</summary>
@@ -3211,7 +3211,7 @@ using (var surface = SKSurface.Create(info)) {
       </Parameters>
       <Docs>
         <param name="buffer">The pointer to a region holding UTF-8 encoded text to draw.</param>
-        <param name="length">The number of bytes to read from the <paramref name="buffer." /></param>
+        <param name="length">The number of bytes to read from the <paramref name="buffer" /></param>
         <param name="x">The x-coordinate of the origin of the text being drawn.</param>
         <param name="y">The y-coordinate of the origin of the text being drawn.</param>
         <param name="paint">The paint to use when drawing the text.</param>
@@ -3452,7 +3452,7 @@ using (var surface = SKSurface.Create(info)) {
       </Parameters>
       <Docs>
         <param name="buffer">The pointer to a region holding UTF-8 encoded text to draw.</param>
-        <param name="length">The number of bytes to read from the <paramref name="buffer." /></param>
+        <param name="length">The number of bytes to read from the <paramref name="buffer" /></param>
         <param name="path">The path the text should follow for its baseline.</param>
         <param name="offset">The offset to the path to add to the text's starting position.</param>
         <param name="paint">The paint to use when drawing the text.</param>
@@ -3595,7 +3595,7 @@ using (var surface = SKSurface.Create(info)) {
       </Parameters>
       <Docs>
         <param name="buffer">The pointer to a region holding UTF-8 encoded text to draw.</param>
-        <param name="length">The number of bytes to read from the <paramref name="buffer." /></param>
+        <param name="length">The number of bytes to read from the <paramref name="buffer" /></param>
         <param name="path">The path the text should follow for its baseline.</param>
         <param name="hOffset">The distance along the path to add to the text's starting position.</param>
         <param name="vOffset">The distance above (-) or below (+) the path to position the text.</param>
@@ -4082,7 +4082,7 @@ safely ignored.
       </ReturnValue>
       <Docs>
         <summary>Gets a value indicating whether the current clip is empty.</summary>
-        <value>true if the clip is empty; otherwise, false.</value>
+        <value><see langword="true" /> if the clip is empty; otherwise, <see langword="false" />.</value>
         <remarks />
       </Docs>
     </Member>
@@ -4103,7 +4103,7 @@ safely ignored.
       </ReturnValue>
       <Docs>
         <summary>Gets a value indicating whether the current clip is a rectangle.</summary>
-        <value>true if the clip is a rectangle; otherwise, false.</value>
+        <value><see langword="true" /> if the clip is a rectangle; otherwise, <see langword="false" />.</value>
         <remarks />
       </Docs>
     </Member>
@@ -4827,7 +4827,7 @@ guaranteed to happen. If exact clipping is desired, use
         <Parameter Name="dy" Type="System.Single" />
       </Parameters>
       <Docs>
-        <param name="dx">The distance to translate in the x-direction</param>
+        <param name="dx">The distance to translate in the x-direction.</param>
         <param name="dy">The distance to translate in the y-direction.</param>
         <summary>Pre-concatenates the current matrix with the specified translation.</summary>
         <remarks />

SkiaSharpAPI/SkiaSharp/SKColorSpace.xml

@@ -576,7 +576,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Creates a new instance of <see cref="T:SkiaSharp.SKColorSpace" /> with the sRGB primaries, but a linear (1.0) gamma</summary>
+        <summary>Creates a new instance of <see cref="T:SkiaSharp.SKColorSpace" /> with the sRGB primaries, but a linear (1.0) gamma.</summary>
         <returns>Returns the new instance of <see cref="T:SkiaSharp.SKColorSpace" />.</returns>
         <remarks />
       </Docs>

SkiaSharpAPI/SkiaSharp/SKColorTable.xml

@@ -240,7 +240,7 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="index"></param>
+        <param name="index">The index of the color to retrieve.</param>
         <summary>Gets the premultiplied color at the specified index.</summary>
         <value>The premultiplied color at the specified index.</value>
         <remarks />

SkiaSharpAPI/SkiaSharp/SKFontStyleSet.xml

@@ -33,7 +33,7 @@
     </Interface>
   </Interfaces>
   <Docs>
-    <summary>Represets the set of styles for a particular font family.</summary>
+    <summary>Represents the set of styles for a particular font family.</summary>
     <remarks />
   </Docs>
   <Members>

SkiaSharpAPI/SkiaSharp/SKFrontBufferedManagedStream.xml

@@ -229,7 +229,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Implemented by derived <see cref="T:SkiaSharp.SKAbstractManagedStream" /> types to get the current position in the stream</summary>
+        <summary>Implemented by derived <see cref="T:SkiaSharp.SKAbstractManagedStream" /> types to get the current position in the stream.</summary>
         <returns>Returns the current position in the stream.</returns>
         <remarks />
       </Docs>

SkiaSharpAPI/SkiaSharp/SKImage.xml

@@ -71,7 +71,7 @@
         <param name="filter">The filter to apply to the current image.</param>
         <param name="subset">The active portion of this image.</param>
         <param name="clipBounds">Constrains the device-space extent of the image to the given rectangle.</param>
-        <param name="outSubset">The active portion of the resulting image</param>
+        <param name="outSubset">The active portion of the resulting image.</param>
         <param name="outOffset">The amount to translate the resulting image relative to the source when it is drawn.</param>
         <summary>Applies a given image filter to this image, and return the filtered result.</summary>
         <returns>Returns the resulting image after the filter is applied, or <see langword="null" /> if the image could not be created or would be transparent black (#00000000).</returns>
@@ -104,7 +104,7 @@
         <param name="filter">The filter to apply to the current image.</param>
         <param name="subset">The active portion of this image.</param>
         <param name="clipBounds">Constrains the device-space extent of the image to the given rectangle.</param>
-        <param name="outSubset">The active portion of the resulting image</param>
+        <param name="outSubset">The active portion of the resulting image.</param>
         <param name="outOffset">The amount to translate the resulting image relative to the source when it is drawn.</param>
         <summary>Applies a given image filter to this image, and return the filtered result.</summary>
         <returns>Returns the resulting image after the filter is applied, or <see langword="null" /> if the image could not be created or would be transparent black (#00000000).</returns>
@@ -1739,7 +1739,7 @@
         <param name="texture">The description of the existing backend texture.</param>
         <param name="colorType">The color type to use for the image.</param>
         <summary>Creates a new image from the specified texture.</summary>
-        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported</returns>
+        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -1868,7 +1868,7 @@
         <param name="origin">The origin of the texture.</param>
         <param name="colorType">The color type to use for the image.</param>
         <summary>Creates a new image from the specified texture.</summary>
-        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported</returns>
+        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -2005,7 +2005,7 @@
         <param name="colorType">The color type to use for the image.</param>
         <param name="alpha">The transparency mode to use for the image.</param>
         <summary>Creates a new image from the specified texture.</summary>
-        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported</returns>
+        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -2044,7 +2044,7 @@
         <param name="releaseProc">The delegate to invoke when the image is about to be destroyed.</param>
         <param name="releaseContext">The user data to use when invoking the delegate.</param>
         <summary>Creates a new image from the specified texture descriptor.</summary>
-        <returns>Returns the new image, or <see langword="null" /> if the specified descriptor is unsupported</returns>
+        <returns>Returns the new image, or <see langword="null" /> if the specified descriptor is unsupported.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -2083,7 +2083,7 @@
         <param name="releaseProc">The delegate to invoke when the image is about to be destroyed.</param>
         <param name="releaseContext">The user data to use when invoking the delegate.</param>
         <summary>Creates a new image from the specified OpenGL texture descriptor.</summary>
-        <returns>Returns the new image, or <see langword="null" /> if the specified descriptor is unsupported</returns>
+        <returns>Returns the new image, or <see langword="null" /> if the specified descriptor is unsupported.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -2150,7 +2150,7 @@
         <param name="alpha">The transparency mode to use for the image.</param>
         <param name="colorspace">The colorspace to use for the image.</param>
         <summary>Creates a new image from the specified texture.</summary>
-        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported</returns>
+        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -2221,7 +2221,7 @@
         <param name="colorspace">The colorspace to use for the image.</param>
         <param name="releaseProc">The delegate to invoke when the image is about to be destroyed.</param>
         <summary>Creates a new image from the specified texture.</summary>
-        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported</returns>
+        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -2296,7 +2296,7 @@
         <param name="releaseProc">The delegate to invoke when the image is about to be destroyed.</param>
         <param name="releaseContext">The user data to use when invoking the delegate.</param>
         <summary>Creates a new image from the specified texture.</summary>
-        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported</returns>
+        <returns>Returns the new image, or <see langword="null" /> if the specified texture is unsupported.</returns>
         <remarks />
       </Docs>
     </Member>

SkiaSharpAPI/SkiaSharp/SKManagedStream.xml

@@ -281,7 +281,7 @@ public static void BitmapShader (SKCanvas canvas, int width, int height)
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Implemented by derived <see cref="T:SkiaSharp.SKAbstractManagedStream" /> types to get the current position in the stream</summary>
+        <summary>Implemented by derived <see cref="T:SkiaSharp.SKAbstractManagedStream" /> types to get the current position in the stream.</summary>
         <returns>Returns the current position in the stream.</returns>
         <remarks />
       </Docs>