Documentation refresh

- add links to types within methods
- add check to see that all references and definitions match
- add style to tables to make them easier to read
- use https everywhere
- remove trailing spaces
- move overview inside class
- split class and struct in summary tables
- add missing #Line
- clean up SkImageInfo constant documentation
- work on SkColor documentation
- allow common phrases to take different parameters
- add more flexibility to generated tables
- tighten token parent requirements
- generalize deprecated and example interfaces
- detect inner constructors

R=caryclark@google.com
Docs-Preview: https://skia.org/?cl=121799
Bug: skia:6898
Change-Id: Ia75a23740b80259460916890b310e2a9f024962a
Reviewed-on: https://skia-review.googlesource.com/121799
Commit-Queue: Cary Clark <caryclark@skia.org>
Auto-Submit: Cary Clark <caryclark@skia.org>
Reviewed-by: Cary Clark <caryclark@skia.org>
diff --git a/docs/SkIPoint_Reference.bmh b/docs/SkIPoint_Reference.bmh
index 9c018d3..61c7394 100644
--- a/docs/SkIPoint_Reference.bmh
+++ b/docs/SkIPoint_Reference.bmh
@@ -2,15 +2,13 @@
 #Alias IPoints
 #Alias IPoint_Reference
 
-#Subtopic Overview
-    #Subtopic Subtopic
-    #Populate
-    ##
-##
-
 #Struct SkIPoint
 
-SkIPoint holds two 32 bit integer coordinates.
+SkIPoint holds two 32-bit integer coordinates.
+
+#Subtopic Overview
+#Populate
+##
 
 #Subtopic Related_Function
 #Populate
@@ -453,10 +451,20 @@
 
 #Struct SkIPoint ##
 
-#Topic IPoint ##
 
-#Topic IVector
+#Subtopic IVector
+#Line # alias for IPoint ##
+    #Alias IVector
     #Alias IVectors
     #Typedef SkIPoint SkIVector
+    #Line # alias for IPoint ##
+    #Code
+    typedef SkIPoint SkIVector;
+    ##
+    SkIVector provides an alternative name for SkIPoint. SkIVector and SkIPoint
+    can be used interchangably for all purposes.
     #Typedef ##
 ##
+
+#Topic IPoint ##
+