starting next gaggle of docs

starting next gaggle of docs

Docs-Preview: https://skia.org/?cl=50264
Bug: skia:6898
Change-Id: I639795b55c0c96b2efccac13cb67592f055a75a2
Reviewed-on: https://skia-review.googlesource.com/50264
Commit-Queue: Cary Clark <caryclark@skia.org>
Reviewed-by: Cary Clark <caryclark@skia.org>

1 files changed, 62 insertions, 64 deletions

diff --git a/docs/SkCanvas_Reference.bmh b/docs/SkCanvas_Reference.bmh
index d3121ba899..3e7369176e 100644
--- a/docs/SkCanvas_Reference.bmh
+++ b/docs/SkCanvas_Reference.bmh
@@ -261,7 +261,7 @@ width times bytes required for Image_Color_Type.
 Pixel buffer size should be height times rowBytes.
 
 #Param width  pixel column count on Raster_Surface created; must be zero or greater ##
-#Param height  pixel row count on Raster_Surface created.; must be zero or greater ##
+#Param height  pixel row count on Raster_Surface created; must be zero or greater ##
 #Param pixels  pointer to destination pixels buffer; buffer size should be height
                times rowBytes
 ##
@@ -284,7 +284,7 @@ void draw(SkCanvas* ) {
     std::unique_ptr<SkCanvas> canvas = SkCanvas::MakeRasterDirectN32(
             width,
             height,
-            pixels[0],  // top left of the bitmap
+            pixels[0],  // top-left of the bitmap
             sizeof(pixels[0]));  // byte width of the each row
     // write a premultiplied value for white into all pixels in the bitmap
     canvas->clear(SK_ColorWHITE);
@@ -453,7 +453,7 @@ The actual output depends on the installed fonts.
     if (!canvas.peekPixels(&pixmap)) {
         SkDebugf("peekPixels should never fail.\n");
     }
-    const SkPMColor* pixels = pixmap.addr32();  // points to top left of bitmap
+    const SkPMColor* pixels = pixmap.addr32();  // points to top-left of bitmap
     SkPMColor pmWhite = pixels[0];  // the Premultiplied format may vary
     SkPaint paint;  // by default, draws black, 12 point text
     canvas.drawString("!", 1, 10, paint);  // 1 char at baseline (1, 10)
@@ -545,7 +545,7 @@ The actual output depends on the installed fonts.
     if (!canvas.peekPixels(&pixmap)) {
         SkDebugf("peekPixels should never fail.\n");
     }
-    const SkPMColor* pixels = pixmap.addr32();  // points to top left of bitmap
+    const SkPMColor* pixels = pixmap.addr32();  // points to top-left of bitmap
     SkPMColor pmWhite = pixels[0];  // the Premultiplied format may vary
     SkPaint paint;  // by default, draws black, 12 point text
     canvas.drawString("!", 1, 10, paint);  // 1 char at baseline (1, 10)
@@ -814,7 +814,7 @@ If pixels are inaccessible, info, rowBytes, and origin are unchanged.
 
 #Param info      storage for writable pixels' Image_Info; may be nullptr ##
 #Param rowBytes  storage for writable pixels' row bytes; may be nullptr ##
-#Param origin    storage for Canvas top Layer origin, its top left corner;
+#Param origin    storage for Canvas top Layer origin, its top-left corner;
                  may be nullptr
 ##
 
@@ -888,7 +888,7 @@ void draw(SkCanvas* canvas) {
 Returns custom context that tracks the Matrix and Clip.
 
 Use Raster_Handle_Allocator to blend Skia drawing with custom drawing, typically performed
-by the host platform's user interface. The custom context returned is generated by
+by the host platform user interface. The custom context returned is generated by
 SkRasterHandleAllocator::MakeCanvas, which creates a custom canvas with raster storage for
 the drawing destination.
 
@@ -954,9 +954,7 @@ like SkDumpCanvas.
 pixmap is valid only while Canvas is in scope and unchanged. Any
 Canvas or Surface call may invalidate the pixmap values.
 
-#Param pixmap  storage for Canvas pixel state if Canvas pixels are readable;
-               otherwise, ignored
-##
+#Param pixmap  storage for pixel state if pixels are readable; otherwise, ignored ##
 
 #Return  true if Canvas has direct access to pixels ##
 
@@ -2651,7 +2649,7 @@ before it is combined with Clip.
 
 #Example
 #Description
-Overlapping Rects form a clip. When clip's Path_Fill_Type is set to
+Overlapping Rects form a clip. When clip Path_Fill_Type is set to
 SkPath::kWinding_FillType, the overlap is included. Set to 
 SkPath::kEvenOdd_FillType, the overlap is excluded and forms a hole.
 ##
@@ -2692,7 +2690,7 @@ path is transformed by Matrix before it is combined with Clip.
 #Example
 #Height 212
 #Description
-Clip loops over itself covering its center twice. When clip's Path_Fill_Type 
+Clip loops over itself covering its center twice. When clip Path_Fill_Type 
 is set to SkPath::kWinding_FillType, the overlap is included. Set to 
 SkPath::kEvenOdd_FillType, the overlap is excluded and forms a hole.
 ##
@@ -3367,7 +3365,7 @@ In paint: Paint_Style determines if rectangle is stroked or filled;
 if stroked, Paint_Stroke_Width describes the line thickness, and
 Paint_Stroke_Join draws the corners rounded or square.
 
-#Param  rect     rectangle to be drawn ##
+#Param  rect     rectangle to draw ##
 #Param  paint    stroke or fill, blend, color, and so on, used to draw ##
 
 #Example
@@ -3403,7 +3401,7 @@ In paint: Paint_Style determines if rectangle is stroked or filled;
 if stroked, Paint_Stroke_Width describes the line thickness, and
 Paint_Stroke_Join draws the corners rounded or square.
 
-#Param  rect     rectangle to be drawn ##
+#Param  rect     rectangle to draw ##
 #Param  paint    stroke or fill, blend, color, and so on, used to draw ##
 
 #Example
@@ -3433,7 +3431,7 @@ In paint: Paint_Style determines if rectangle is stroked or filled;
 if stroked, Paint_Stroke_Width describes the line thickness, and
 Paint_Stroke_Join draws the corners rounded or square.
 
-#Param  region   region to be drawn ##
+#Param  region   region to draw ##
 #Param  paint    Paint stroke or fill, blend, color, and so on, used to draw ##
 
 #Example
@@ -3825,7 +3823,7 @@ and Draw_Looper. If image is kAlpha_8_SkColorType, apply Shader.
 If paint contains Mask_Filter, generate mask from image bounds. If generated
 mask extends beyond image bounds, replicate image edge colors, just as Shader
 made from SkImage::makeShader with SkShader::kClamp_TileMode set replicates the
-image's edge color when it samples outside of its bounds. 
+image edge color when it samples outside of its bounds. 
 
 #Param  image    uncompressed rectangular map of pixels ##
 #Param  left     left side of image ##
@@ -3865,7 +3863,7 @@ Blend_Mode, and Draw_Looper. If image is kAlpha_8_SkColorType, apply Shader.
 If paint contains Mask_Filter, generate mask from image bounds. If generated
 mask extends beyond image bounds, replicate image edge colors, just as Shader
 made from SkImage::makeShader with SkShader::kClamp_TileMode set replicates the
-image's edge color when it samples outside of its bounds. 
+image edge color when it samples outside of its bounds. 
 
 #Param  image    uncompressed rectangular map of pixels ##
 #Param  left     left side of image ##
@@ -3974,7 +3972,7 @@ If paint contains Mask_Filter, generate mask from image bounds.
 
 If generated mask extends beyond image bounds, replicate image edge colors, just
 as Shader made from SkImage::makeShader with SkShader::kClamp_TileMode set
-replicates the image's edge color when it samples outside of its bounds.
+replicates the image edge color when it samples outside of its bounds.
 
 constraint set to kStrict_SrcRectConstraint limits Paint Filter_Quality to
 sample within src; set to kFast_SrcRectConstraint allows sampling outside to
@@ -3992,7 +3990,7 @@ improve performance.
 #Height 64
 #Description
     The left bitmap draws with Paint default kNone_SkFilterQuality, and stays within
-    its bounds; there's no bleeding with kFast_SrcRectConstraint.
+    its bounds; there is no bleeding with kFast_SrcRectConstraint.
     the middle and right bitmaps draw with kLow_SkFilterQuality; with
     kStrict_SrcRectConstraint, the filter remains within the checkerboard, and
     with kFast_SrcRectConstraint red bleeds on the edges.
@@ -4040,7 +4038,7 @@ If paint contains Mask_Filter, generate mask from image bounds.
 
 If generated mask extends beyond image bounds, replicate image edge colors, just
 as Shader made from SkImage::makeShader with SkShader::kClamp_TileMode set
-replicates the image's edge color when it samples outside of its bounds.
+replicates the image edge color when it samples outside of its bounds.
 
 constraint set to kStrict_SrcRectConstraint limits Paint Filter_Quality to
 sample within isrc; set to kFast_SrcRectConstraint allows sampling outside to
@@ -4083,7 +4081,7 @@ If paint contains Mask_Filter, generate mask from image bounds.
 
 If generated mask extends beyond image bounds, replicate image edge colors, just
 as Shader made from SkImage::makeShader with SkShader::kClamp_TileMode set
-replicates the image's edge color when it samples outside of its bounds.
+replicates the image edge color when it samples outside of its bounds.
 
 constraint set to kStrict_SrcRectConstraint limits Paint Filter_Quality to
 sample within image; set to kFast_SrcRectConstraint allows sampling outside to
@@ -4125,7 +4123,7 @@ If paint contains Mask_Filter, generate mask from image bounds.
 
 If generated mask extends beyond image bounds, replicate image edge colors, just
 as Shader made from SkImage::makeShader with SkShader::kClamp_TileMode set
-replicates the image's edge color when it samples outside of its bounds.
+replicates the image edge color when it samples outside of its bounds.
 
 constraint set to kStrict_SrcRectConstraint limits Paint Filter_Quality to
 sample within src; set to kFast_SrcRectConstraint allows sampling outside to
@@ -4181,7 +4179,7 @@ If paint contains Mask_Filter, generate mask from image bounds.
 
 If generated mask extends beyond image bounds, replicate image edge colors, just
 as Shader made from SkImage::makeShader with SkShader::kClamp_TileMode set
-replicates the image's edge color when it samples outside of its bounds.
+replicates the image edge color when it samples outside of its bounds.
 
 constraint set to kStrict_SrcRectConstraint limits Paint Filter_Quality to
 sample within image; set to kFast_SrcRectConstraint allows sampling outside to
@@ -4231,7 +4229,7 @@ If paint contains Mask_Filter, generate mask from image bounds.
 
 If generated mask extends beyond image bounds, replicate image edge colors, just
 as Shader made from SkImage::makeShader with SkShader::kClamp_TileMode set
-replicates the image's edge color when it samples outside of its bounds.
+replicates the image edge color when it samples outside of its bounds.
 
 constraint set to kStrict_SrcRectConstraint limits Paint Filter_Quality to
 sample within image; set to kFast_SrcRectConstraint allows sampling outside to
@@ -4285,7 +4283,7 @@ If paint contains Mask_Filter, generate mask from image bounds.
 
 If generated mask extends beyond image bounds, replicate image edge colors, just
 as Shader made from SkImage::makeShader with SkShader::kClamp_TileMode set
-replicates the image's edge color when it samples outside of its bounds.
+replicates the image edge color when it samples outside of its bounds.
 
 #Param  image      Image containing pixels, dimensions, and format ##
 #Param  center     IRect edge of image corners and sides ##
@@ -4351,7 +4349,7 @@ If paint contains Mask_Filter, generate mask from image bounds.
 
 If generated mask extends beyond image bounds, replicate image edge colors, just
 as Shader made from SkImage::makeShader with SkShader::kClamp_TileMode set
-replicates the image's edge color when it samples outside of its bounds.
+replicates the image edge color when it samples outside of its bounds.
 
 #Param  image      Image containing pixels, dimensions, and format ##
 #Param  center     IRect edge of image corners and sides ##
@@ -4414,7 +4412,7 @@ If paint contains Mask_Filter, generate mask from bitmap bounds.
 
 If generated mask extends beyond bitmap bounds, replicate bitmap edge colors,
 just as Shader made from SkShader::MakeBitmapShader with
-SkShader::kClamp_TileMode set replicates the bitmap's edge color when it samples
+SkShader::kClamp_TileMode set replicates the bitmap edge color when it samples
 outside of its bounds. 
 
 #Param  bitmap   Bitmap containing pixels, dimensions, and format ##
@@ -4466,7 +4464,7 @@ If paint contains Mask_Filter, generate mask from bitmap bounds.
 
 If generated mask extends beyond bitmap bounds, replicate bitmap edge colors,
 just as Shader made from SkShader::MakeBitmapShader with
-SkShader::kClamp_TileMode set replicates the bitmap's edge color when it samples
+SkShader::kClamp_TileMode set replicates the bitmap edge color when it samples
 outside of its bounds.
 
 constraint set to kStrict_SrcRectConstraint limits Paint Filter_Quality to
@@ -4524,7 +4522,7 @@ If paint contains Mask_Filter, generate mask from bitmap bounds.
 
 If generated mask extends beyond bitmap bounds, replicate bitmap edge colors,
 just as Shader made from SkShader::MakeBitmapShader with
-SkShader::kClamp_TileMode set replicates the bitmap's edge color when it samples
+SkShader::kClamp_TileMode set replicates the bitmap edge color when it samples
 outside of its bounds.
 
 constraint set to kStrict_SrcRectConstraint limits Paint Filter_Quality to
@@ -4582,7 +4580,7 @@ If paint contains Mask_Filter, generate mask from bitmap bounds.
 
 If generated mask extends beyond bitmap bounds, replicate bitmap edge colors,
 just as Shader made from SkShader::MakeBitmapShader with
-SkShader::kClamp_TileMode set replicates the bitmap's edge color when it samples
+SkShader::kClamp_TileMode set replicates the bitmap edge color when it samples
 outside of its bounds.
 
 constraint set to kStrict_SrcRectConstraint limits Paint Filter_Quality to
@@ -4637,7 +4635,7 @@ If paint contains Mask_Filter, generate mask from bitmap bounds.
 
 If generated mask extends beyond bitmap bounds, replicate bitmap edge colors,
 just as Shader made from SkShader::MakeBitmapShader with
-SkShader::kClamp_TileMode set replicates the bitmap's edge color when it samples
+SkShader::kClamp_TileMode set replicates the bitmap edge color when it samples
 outside of its bounds.
 
 #Param  bitmap     Bitmap containing pixels, dimensions, and format ##
@@ -4777,7 +4775,7 @@ Draw Bitmap bitmap stretched proportionally to fit into Rect dst.
 Lattice lattice divides bitmap into a rectangular grid.
 Each intersection of an even-numbered row and column is fixed; like the corners
 of drawBitmapNine, fixed lattice elements never scale larger than their initial
-size and shrink proportionately when all fixed elements exceed the bitmap's
+size and shrink proportionately when all fixed elements exceed the bitmap
 dimension. All other grid elements scale to fill the available space, if any.
 
 Additionally transform draw using Clip, Matrix, and optional Paint paint.
@@ -4788,7 +4786,7 @@ If paint contains Mask_Filter, generate mask from bitmap bounds.
 
 If generated mask extends beyond bitmap bounds, replicate bitmap edge colors,
 just as Shader made from SkShader::MakeBitmapShader with
-SkShader::kClamp_TileMode set replicates the bitmap's edge color when it samples
+SkShader::kClamp_TileMode set replicates the bitmap edge color when it samples
 outside of its bounds.
 
 #Param  bitmap     Bitmap containing pixels, dimensions, and format ##
@@ -4854,7 +4852,7 @@ Draw Image image stretched proportionally to fit into Rect dst.
 Lattice lattice divides image into a rectangular grid.
 Each intersection of an even-numbered row and column is fixed; like the corners
 of drawBitmapNine, fixed lattice elements never scale larger than their initial
-size and shrink proportionately when all fixed elements exceed the bitmap's
+size and shrink proportionately when all fixed elements exceed the bitmap
 dimension. All other grid elements scale to fill the available space, if any.
 
 Additionally transform draw using Clip, Matrix, and optional Paint paint.
@@ -4865,7 +4863,7 @@ If paint contains Mask_Filter, generate mask from bitmap bounds.
 
 If generated mask extends beyond bitmap bounds, replicate bitmap edge colors,
 just as Shader made from SkShader::MakeBitmapShader with
-SkShader::kClamp_TileMode set replicates the bitmap's edge color when it samples
+SkShader::kClamp_TileMode set replicates the bitmap edge color when it samples
 outside of its bounds.
 
 #Param  image      Image containing pixels, dimensions, and format ##
@@ -4930,11 +4928,11 @@ void draw(SkCanvas* canvas) {
 
 Draw text, with origin at (x, y), using Clip, Matrix, and Paint paint.
 
-text's meaning depends on Paint_Text_Encoding; by default, text encoding is
+text meaning depends on Paint_Text_Encoding; by default, text is encoded as
 UTF-8.
 
 x and y meaning depends on Paint_Text_Align and Paint_Vertical_Text; by default
-text draws left to right, positioning the first glyph's left side bearing at x
+text draws left to right, positioning the first glyph left side bearing at x
 and its baseline at y. Text size is affected by Matrix and Paint_Text_Size. 
 
 All elements of paint: Path_Effect, Rasterizer, Mask_Filter, Shader,
@@ -4985,12 +4983,12 @@ void draw(SkCanvas* canvas) {
 Draw null terminated string, with origin at (x, y), using Clip, Matrix, and
 Paint paint.
 
-string's meaning depends on Paint_Text_Encoding; by default, string encoding is
-UTF-8. Other values of Paint_Text_Encoding are unlikely to produce the desired
+string meaning depends on Paint_Text_Encoding; by default, strings are encoded
+as UTF-8. Other values of Paint_Text_Encoding are unlikely to produce the desired
 results, since zero bytes may be embedded in the string.
 
 x and y meaning depends on Paint_Text_Align and Paint_Vertical_Text; by default
-string draws left to right, positioning the first glyph's left side bearing at x
+string draws left to right, positioning the first glyph left side bearing at x
 and its baseline at y. Text size is affected by Matrix and Paint_Text_Size. 
 
 All elements of paint: Path_Effect, Rasterizer, Mask_Filter, Shader,
@@ -5018,12 +5016,12 @@ filled 12 point black Glyphs.
 Draw null terminated string, with origin at (x, y), using Clip, Matrix, and
 Paint paint.
 
-string's meaning depends on Paint_Text_Encoding; by default, string encoding is
-UTF-8. Other values of Paint_Text_Encoding are unlikely to produce the desired
+string meaning depends on Paint_Text_Encoding; by default, strings are encoded
+as UTF-8. Other values of Paint_Text_Encoding are unlikely to produce the desired
 results, since zero bytes may be embedded in the string.
 
 x and y meaning depends on Paint_Text_Align and Paint_Vertical_Text; by default
-string draws left to right, positioning the first glyph's left side bearing at x
+string draws left to right, positioning the first glyph left side bearing at x
 and its baseline at y. Text size is affected by Matrix and Paint_Text_Size. 
 
 All elements of paint: Path_Effect, Rasterizer, Mask_Filter, Shader,
@@ -5056,9 +5054,9 @@ Draw each glyph in text with the origin in pos array, using Clip, Matrix, and
 Paint paint. The number of entries in pos array must match the number of Glyphs
 described by byteLength of text.
 
-text's meaning depends on Paint_Text_Encoding; by default, text encoding is
+text meaning depends on Paint_Text_Encoding; by default, text is encoded as
 UTF-8. pos elements' meaning depends on Paint_Text_Align and Paint_Vertical_Text;
-by default each glyph's left side bearing is positioned at x and its
+by default each glyph left side bearing is positioned at x and its
 baseline is positioned at y. Text size is affected by Matrix and
 Paint_Text_Size. 
 
@@ -5067,7 +5065,7 @@ Color_Filter, Image_Filter, and Draw_Looper; apply to text. By default, draws
 filled 12 point black Glyphs.
 
 Layout engines such as Harfbuzz typically position each glyph
-rather than using the font's advance widths.
+rather than using the font advance widths.
 
 #Param  text     character code points or Glyphs drawn ##
 #Param  byteLength   byte length of text array ##
@@ -5099,9 +5097,9 @@ Draw each glyph in text with its (x, y) origin composed from xpos array and
 constY, using Clip, Matrix, and Paint paint. The number of entries in xpos array
 must match the number of Glyphs described by byteLength of text.
 
-text's meaning depends on Paint_Text_Encoding; by default, text encoding is
+text meaning depends on Paint_Text_Encoding; by default, text is encoded as
 UTF-8. xpos elements' meaning depends on Paint_Text_Align and Paint_Vertical_Text;
-by default each glyph's left side bearing is positioned at an xpos element and
+by default each glyph left side bearing is positioned at an xpos element and
 its baseline is positioned at constY. Text size is affected by Matrix and
 Paint_Text_Size. 
 
@@ -5110,7 +5108,7 @@ Color_Filter, Image_Filter, and Draw_Looper; apply to text. By default, draws
 filled 12 point black Glyphs.
 
 Layout engines such as Harfbuzz typically position each glyph
-rather than using the font's advance widths if all Glyphs share the same
+rather than using the font advance widths if all Glyphs share the same
 baseline.
 
 #Param  text     character code points or Glyphs drawn ##
@@ -5142,12 +5140,12 @@ Draw text on Path path, using Clip, Matrix, and Paint paint.
 Origin of text is at distance hOffset along the path, offset by a perpendicular
 vector of length vOffset. If the path section corresponding the glyph advance is
 curved, the glyph is drawn curved to match; control points in the glyph are
-mapped to projected points parallel to the path. If the text's advance is larger
+mapped to projected points parallel to the path. If the text advance is larger
 than the path length, the excess text is clipped.
 
-text's meaning depends on Paint_Text_Encoding; by default, text encoding is
+text meaning depends on Paint_Text_Encoding; by default, text is encoded as
 UTF-8. Origin meaning depends on Paint_Text_Align and Paint_Vertical_Text; by
-default text positions the first glyph's left side bearing at origin x and its
+default text positions the first glyph left side bearing at origin x and its
 baseline at origin y. Text size is affected by Matrix and Paint_Text_Size. 
 
 All elements of paint: Path_Effect, Rasterizer, Mask_Filter, Shader,
@@ -5190,12 +5188,12 @@ Draw text on Path path, using Clip, Matrix, and Paint paint.
 Origin of text is at beginning of path offset by matrix, if provided, before it
 is mapped to path. If the path section corresponding the glyph advance is
 curved, the glyph is drawn curved to match; control points in the glyph are
-mapped to projected points parallel to the path. If the text's advance is larger
+mapped to projected points parallel to the path. If the text advance is larger
 than the path length, the excess text is clipped.
 
-text's meaning depends on Paint_Text_Encoding; by default, text encoding is
+text meaning depends on Paint_Text_Encoding; by default, text is encoded as
 UTF-8. Origin meaning depends on Paint_Text_Align and Paint_Vertical_Text; by
-default text positions the first glyph's left side bearing at origin x and its
+default text positions the first glyph left side bearing at origin x and its
 baseline at origin y. Text size is affected by Matrix and Paint_Text_Size. 
 
 All elements of paint: Path_Effect, Rasterizer, Mask_Filter, Shader,
@@ -5598,20 +5596,20 @@ void draw(SkCanvas* canvas) {
 Draws a Coons patch: the interpolation of four cubics with shared corners, 
 associating a color, and optionally a texture coordinate, with each corner.
 
-The Coons patch uses Clip and Matrix, Paint paint's Shader, Color_Filter,
+The Coons patch uses Clip and Matrix, paint Shader, Color_Filter,
 Color_Alpha, Image_Filter, and Blend_Mode. If Shader is provided it is treated
 as the Coons patch texture; Blend_Mode mode combines Color colors and Shader if
 both are provided.
 
-Point array cubics specifies four Cubics starting at the top left corner, 
+Point array cubics specifies four Cubics starting at the top-left corner, 
 in clockwise order, sharing every fourth point. The last Cubic ends at the
 first point.
 
-Color array color associates colors with corners in top left, top right,
-bottom right, bottom left order.
+Color array color associates colors with corners in top-left, top-right,
+bottom-right, bottom-left order.
 
 If paint contains Shader, Point array texCoords maps Shader as texture to
-corners in top left, top right, bottom right, bottom left order.
+corners in top-left, top-right, bottom-right, bottom-left order.
 
 #Param cubics     Path_Cubic array, sharing common points ##
 #Param colors     Color array, one for each corner ##
@@ -5656,20 +5654,20 @@ void draw(SkCanvas* canvas) {
 Draws Cubic Coons patch: the interpolation of four cubics with shared corners, 
 associating a color, and optionally a texture coordinate, with each corner.
 
-The Coons patch uses Clip and Matrix, Paint paint's Shader, Color_Filter,
+The Coons patch uses Clip and Matrix, paint Shader, Color_Filter,
 Color_Alpha, Image_Filter, and Blend_Mode. If Shader is provided it is treated
 as the Coons patch texture; Blend_Mode mode combines Color colors and Shader if
 both are provided.
 
-Point array cubics specifies four Cubics starting at the top left corner, 
+Point array cubics specifies four Cubics starting at the top-left corner, 
 in clockwise order, sharing every fourth point. The last Cubic ends at the
 first point.
 
-Color array color associates colors with corners in top left, top right,
-bottom right, bottom left order.
+Color array color associates colors with corners in top-left, top-right,
+bottom-right, bottom-left order.
 
 If paint contains Shader, Point array texCoords maps Shader as texture to
-corners in top left, top right, bottom right, bottom left order.
+corners in top-left, top-right, bottom-right, bottom-left order.
 
 #Param cubics     Path_Cubic array, sharing common points ##
 #Param colors     Color array, one for each corner ##