commit a90ea228ab22995e3d3798fa229a89e5cacf8f3f
author Cary Clark <caryclark@skia.org> Tue Oct 16 10:30:28 2018 -0400
committer Skia Commit-Bot <skia-commit-bot@chromium.org> Tue Oct 16 17:35:54 2018 +0000
tree eb370ce6bc456b40248164857ed782728a85b8af
parent 120007cc0bcc4aec3b2852a5c086a817f9c051b1

streamline web documentation

This is the next step in reducing the amount of typing
in bookmaker, and presenting a web-base interface that
more closely matches the include documentation.

Moving towards making xxx_Reference solely contain
use documentation, and xxx_Overview (unpublished)
contain theory of operation documentation.

Fixed quite a few bugs along the way, and made
function and member documentation tighter.

TBR=caryclark@google.com
Docs-Preview: https://skia.org/?cl=160640
Change-Id: I763df4d59baa5dfd0177f0523294b5316434c4b0
Reviewed-on: https://skia-review.googlesource.com/c/160640
Reviewed-by: Cary Clark <caryclark@skia.org>
Commit-Queue: Cary Clark <caryclark@skia.org>
Auto-Submit: Cary Clark <caryclark@skia.org>

docs/SkBitmap_Reference.bmh

diff --git a/docs/SkBitmap_Reference.bmh b/docs/SkBitmap_Reference.bmh
index f4ed0a3..7faaf33 100644
--- a/docs/SkBitmap_Reference.bmh
+++ b/docs/SkBitmap_Reference.bmh
@@ -43,10 +43,7 @@
 #Class Allocator
 #Line # abstract subclass of HeapAllocator ##
 #Code
-    class Allocator : public SkRefCnt {
-    public:
-        virtual bool allocPixelRef(SkBitmap* bitmap) = 0;
-    };
+#Populate
 ##
 
 Abstract subclass of HeapAllocator.
@@ -79,10 +76,7 @@
 #Line # allocates pixel memory from heap ##
 
 #Code
-    class HeapAllocator : public Allocator {
-    public:
-        bool allocPixelRef(SkBitmap* bitmap) override;
-    };
+#Populate
 ##
 
 Subclass of SkBitmap::Allocator that returns a Pixel_Ref that allocates its pixel
@@ -877,12 +871,12 @@
     SkBitmap bitmap;
     SkAlphaType alphaTypes[] = { #list_of_alpha_types#
                                };
-    SkDebugf("%88s", "Canonical    Unknown           Opaque            Premul            Unpremul\n");
+    SkDebugf("%18s%15s%17s%18s%19s\n", "Canonical", "Unknown", "Opaque", "Premul", "Unpremul");
     for (SkColorType colorType : { #list_of_color_types#
                                  } ) {
         for (SkAlphaType canonicalAlphaType : alphaTypes) {
             SkColorTypeValidateAlphaType(colorType, kUnknown_SkAlphaType, &canonicalAlphaType );
-            SkDebugf("%10s %10s ", colors[(int) colorType], alphas[(int) canonicalAlphaType ]);
+            SkDebugf("%12s %9s  ", colors[(int) colorType], alphas[(int) canonicalAlphaType ]);
             for (SkAlphaType alphaType : alphaTypes) {
                 bitmap.setInfo(SkImageInfo::Make(4, 4, colorType, canonicalAlphaType));
                 bool result = bitmap.setAlphaType(alphaType);
@@ -1309,7 +1303,7 @@
     SkDebugf("dimensionsAsBounds %c= bounds\n", dimensionsAsBounds == bounds ? '=' : '!');
 ##
 
-#SeeAlso height() width()
+#SeeAlso height width
 
 ##
 
@@ -1403,9 +1397,7 @@
 #Enum AllocFlags
 #Line # zero pixel memory ##
 #Code
-    enum AllocFlags {
-        kZeroPixels_AllocFlag = 1 << 0,
-    };
+#Populate
 ##
 
 AllocFlags provides the option to zero pixel memory when allocated.
@@ -1418,7 +1410,7 @@
 #NoExample
 ##
 
-#SeeAlso tryAllocPixelsFlags allocPixelsFlags erase() eraseColor
+#SeeAlso tryAllocPixelsFlags allocPixelsFlags erase eraseColor
 
 ##
 
@@ -3213,7 +3205,7 @@
     #StdOut ##
 ##
 
-#SeeAlso pixmap() installPixels readPixels writePixels
+#SeeAlso pixmap installPixels readPixels writePixels
 
 ##