generate tables instead of manual entry

- make descriptions of table entries phrases instead of sentences;
lower case start, no ending period (not enforced, yet)

- add #Line markup to move one line descriptions to the #Method
body. Later, will generate tables like Member_Functions from this

- add #In markup to associate a #Method with a #Subtopic. Later, will
generate tables of related methods from this

- remove return type from operator overloads in tables

- add new colorTypes to examples that index into arrays of strings
to name them


Docs-Preview: https://skia.org/?cl=100422
TBR=caryclark@google.com
Bug: skia:6898
Change-Id: I8558048866369f419f1944832b99c05da3fd52bb
Reviewed-on: https://skia-review.googlesource.com/100422
Reviewed-by: Cary Clark <caryclark@skia.org>
Commit-Queue: Cary Clark <caryclark@skia.org>
diff --git a/docs/SkAutoCanvasRestore_Reference.bmh b/docs/SkAutoCanvasRestore_Reference.bmh
index a01aa79..361fb76 100644
--- a/docs/SkAutoCanvasRestore_Reference.bmh
+++ b/docs/SkAutoCanvasRestore_Reference.bmh
@@ -22,19 +22,19 @@
 #Subtopic Constructors
 #Table
 #Legend
-# name                                               # description                     ##
+# name                                               # description                    ##
 #Legend ##
-# SkAutoCanvasRestore(SkCanvas* canvas, bool doSave) # Preserves Canvas save count.    ##
-# ~SkAutoCanvasRestore()                             # Restores Canvas to saved state. ##
+# SkAutoCanvasRestore(SkCanvas* canvas, bool doSave) # preserves Canvas save count    ##
+# ~SkAutoCanvasRestore()                             # restores Canvas to saved state ##
 #Table ##
 #Subtopic ##
 
 #Subtopic Member_Functions
 #Table
 #Legend
-# name                             # description                     ##
+# name                             # description                    ##
 #Legend ##
-# restore()                        # Restores Canvas to saved state. ##
+# restore()                        # restores Canvas to saved state ##
 #Table ##
 #Subtopic ##
 
@@ -42,6 +42,7 @@
 
 #Method SkAutoCanvasRestore(SkCanvas* canvas, bool doSave)
 
+#Line # preserves Canvas save count ##
 Preserves Canvas save count. Optionally saves Canvas_Clip and Canvas_Matrix.
 
 #Param canvas  Canvas to guard ##
@@ -70,6 +71,7 @@
 
 #Method ~SkAutoCanvasRestore()
 
+#Line # restores Canvas to saved state ##
 Restores Canvas to saved state. Destructor is called when container goes out of
 scope.
 
@@ -82,6 +84,7 @@
 
 #Method void restore()
 
+#Line # restores Canvas to saved state ##
 Restores Canvas to saved state immediately. Subsequent calls and
 ~SkAutoCanvasRestore have no effect.