bookmaker does deprecated

Bookmaker does not require documentation for public symbols
described as "deprecated", "private", or "experimental".
Adding one of these words (case-insensitive) to the symbol
description in the include file tells bookmaker that the bmh file
should not include documentation, and the generated markdown
should omit it in its indices and descriptions.

Symbols marked as "to be deprecated" or "may be deprecated"
are still regarded as public and documented.

Private notes in the includes that start with TODO: are
omitted as well.

This CL updated generated includes to describe its symbols
accordingly. The includes will be fully regenerated in a future
CL. The corresponding documentation has been deleted from the
bmh files, and the web markup has been regenerated.

TBR=reed@google.com
Docs-Preview: https://skia.org/?cl=169830
Bug: skia:
Change-Id: Ie6ec3ccdadb7be9ac15db4811823a30948c4af25
Reviewed-on: https://skia-review.googlesource.com/c/169830
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/SkBitmap_Reference.bmh b/docs/SkBitmap_Reference.bmh
index 7a44af5..f0b50f9 100644
--- a/docs/SkBitmap_Reference.bmh
+++ b/docs/SkBitmap_Reference.bmh
@@ -1539,12 +1539,6 @@
 ##
 
 # ------------------------------------------------------------------------------
-
-#Method bool installMaskPixels(const SkMask& mask)
-#Deprecated soon
-##
-
-# ------------------------------------------------------------------------------
 #Subtopic Pixels
 #Line # read and write pixel values ##
 ##
@@ -1951,12 +1945,6 @@
 
 # ------------------------------------------------------------------------------
 
-#Method void eraseArea(const SkIRect& area, SkColor c) const
-#Deprecated
-##
-
-# ------------------------------------------------------------------------------
-
 #Method SkColor getColor(int x, int y) const
 #In Property
 #In Pixels
diff --git a/docs/SkCanvas_Reference.bmh b/docs/SkCanvas_Reference.bmh
index 11eb24c..468a903 100644
--- a/docs/SkCanvas_Reference.bmh
+++ b/docs/SkCanvas_Reference.bmh
@@ -189,12 +189,6 @@
 
 # ------------------------------------------------------------------------------
 
-#Method explicit SkCanvas(sk_sp<SkBaseDevice> device)
-#Deprecated soon
-##
-
-# ------------------------------------------------------------------------------
-
 #Method explicit SkCanvas(const SkBitmap& bitmap)
 
 #Line # uses existing Bitmap ##
@@ -243,30 +237,6 @@
 
 ##
 
-#EnumClass ColorBehavior
-#Line # exists for Android framework only ##
-#Private
-Android framework only.
-##
-
-#Code
-#Populate
-##
-#Const kLegacy 0
-#Line # placeholder ##
-    Is a placeholder to allow specialized constructor; has no meaning.
-##
-##
-
-#Method SkCanvas(const SkBitmap& bitmap, ColorBehavior behavior)
-
-#Line # exists for Android framework only ##
-#Populate
-
-#NoExample
-##
-##
-
 # ------------------------------------------------------------------------------
 
 #Method SkCanvas(const SkBitmap& bitmap, const SkSurfaceProps& props)
@@ -446,7 +416,7 @@
 #NoExample
 ##
 
-#SeeAlso peekPixels SkSurface::flush GrContext::flush SkSurface::prepareForExternalIO GrContext::abandonContext
+#SeeAlso peekPixels SkSurface::flush GrContext::flush GrContext::abandonContext
 
 ##
 
@@ -1374,14 +1344,6 @@
   Initializes Layer with the contents of the previous Layer.
 ##
 
-#Const kMaskAgainstCoverage_EXPERIMENTAL_DONT_USE_SaveLayerFlag 8
-#Experimental  do not use
-##
-
-#Const kDontClipToLayer_Legacy_SaveLayerFlag 0x80000000
-#Deprecated soon
-##
-
 #Example
 #Height 160
 #Description
@@ -1550,37 +1512,6 @@
 
 ##
 
-#Method SaveLayerRec(const SkRect* bounds, const SkPaint* paint, const SkImageFilter* backdrop,
-                     const SkImage* clipMask, const SkMatrix* clipMatrix,
-                     SaveLayerFlags saveLayerFlags)
-
-#Experimental  not ready
-
-Sets fBounds, fPaint, fBackdrop, fClipMask, fClipMatrix, and fSaveLayerFlags.
-clipMatrix uses Color_Alpha channel of image, transformed by clipMatrix, to clip
-Layer when drawn to Canvas.
-
-Implementation is not complete; has no effect if Device is GPU-backed.
-
-#Param bounds          Layer dimensions; may be nullptr ##
-#Param paint           graphics state applied to Layer when overlaying prior
-                       Layer; may be nullptr
-##
-#Param backdrop        prior Layer copied with Image_Filter;
-                       may be nullptr
-##
-#Param clipMask        clip applied to Layer; may be nullptr ##
-#Param clipMatrix      matrix applied to clipMask; may be nullptr to use
-                       identity matrix
-##
-#Param saveLayerFlags  SaveLayerRec options to modify Layer ##
-
-#Return                SaveLayerRec fully specified ##
-
-#SeeAlso save restore saveLayer saveLayerPreserveLCDTextRequests saveLayerAlpha
-
-##
-
 #Struct ##
 
 #Subtopic ##
@@ -2025,26 +1956,6 @@
 
 ##
 
-#Method void androidFramework_setDeviceClipRestriction(const SkIRect& rect)
-
-#In Clip
-#Line # exists for use by Android framework ##
-Sets the maximum clip rectangle, which can be set by clipRect, clipRRect and
-clipPath and intersect the current clip with the specified rect.
-The maximum clip affects only future clipping operations; it is not retroactive.
-The clip restriction is not recorded in pictures.
-
-Pass an empty rect to disable maximum clip.
-
-#Private
-This private API is for use by Android framework only.
-##
-
-#Param  rect   maximum allowed clip in device coordinates
-#Param ##
-
-##
-
 #Method void clipRRect(const SkRRect& rrect, SkClipOp op, bool doAntiAlias)
 
 #In Clip
@@ -2214,17 +2125,6 @@
 
 # ------------------------------------------------------------------------------
 
-#Method void setAllowSimplifyClip(bool allow)
-
-#In Clip
-#Experimental  testing
-
-Set to simplify clip stack using PathOps.
-
-##
-
-# ------------------------------------------------------------------------------
-
 #Method void clipRegion(const SkRegion& deviceRgn, SkClipOp op = SkClipOp::kIntersect)
 
 #In Clip
@@ -2520,7 +2420,7 @@
 #NoExample
 ##
 
-#SeeAlso flush() SkSurface::prepareForExternalIO GrContext::abandonContext
+#SeeAlso flush() GrContext::abandonContext
 
 ##
 
@@ -4012,104 +3912,6 @@
 
 #Subtopic Lattice ##
 
-# ------------------------------------------------------------------------------
-
-#Enum QuadAAFlags
-#Line # do not use this ##
-#Code
-#Populate
-##
-
-#Private
-Do not use.
-##
-
-#Const kLeft_QuadAAFlag 1
-#Line # antialias the left edge ##
-##
-
-#Const kTop_QuadAAFlag 2
-#Line # antialias the top edge ##
-##
-
-#Const kRight_QuadAAFlag 4
-#Line # antialias the right edge ##
-##
-
-#Const kBottom_QuadAAFlag 8
-#Line # antialias the bottom edge ##
-##
-
-#Const kNone_QuadAAFlags 0
-#Line # antialias none of the edges ##
-##
-
-#Const kAll_QuadAAFlags 15
-#Line # antialias all of the edges ##
-##
-
-#NoExample
-##
-##
-
-# ------------------------------------------------------------------------------
-
-#Struct ImageSetEntry
-#Line # do not use this ##
-
-#Code
-#Populate
-##
-
-#Private
-Do not use.
-##
-
-#Member SkImage* fImage
-#Line # image to draw ##
-##
-
-#Member SkRect   fSrcRect
-#Line # image src rectangle ##
-##
-
-#Member SkRect   fDstRect
-#Line # local space rectangle ##
-##
-
-#Member unsigned fAAFlags
-#Line # antialiasing flags ##
-##
-
-#NoExample
-##
-
-##
-
-# ------------------------------------------------------------------------------
-
-#Method void experimental_DrawImageSetV0(const ImageSetEntry imageSet[], int cnt, float alpha,
-                                         SkFilterQuality quality, SkBlendMode mode);
-#Private
-Do not use.
-##
-#In Draw_Image
-#In Draw
-#Line # draws a set a of images; do not call this ##
-
-Draws a set of images. Do not use this method.
-
-#Param  imageSet   images ##
-#Param  cnt        number of images ##
-#Param  alpha      alpha ##
-#Param  quality    filter quality ##
-#Param  mode       blend mode ##
-
-#NoExample
-##
-
-##
-
 #Subtopic Draw_Image ##
 
 # ------------------------------------------------------------------------------
diff --git a/docs/SkImage_Reference.bmh b/docs/SkImage_Reference.bmh
index 9a68740..97538cd 100644
--- a/docs/SkImage_Reference.bmh
+++ b/docs/SkImage_Reference.bmh
@@ -999,12 +999,6 @@
 
 # ------------------------------------------------------------------------------
 
-#Method GrTexture* getTexture() const
-#Deprecated
-#Method ##
-
-# ------------------------------------------------------------------------------
-
 #Method bool isTextureBacked() const
 #In Property
 #Line # returns if Image was created from GPU_Texture ##
@@ -1624,51 +1618,6 @@
 
 # ------------------------------------------------------------------------------
 
-#Enum LegacyBitmapMode
-#Deprecated soon
-#Code
-#Populate
-##
-
-#Const kRO_LegacyBitmapMode 0
-#Line # returned bitmap is read-only and immutable ##
-##
-
-#Enum ##
-
-# ------------------------------------------------------------------------------
-
-#Method bool asLegacyBitmap(SkBitmap* bitmap, LegacyBitmapMode legacyBitmapMode = kRO_LegacyBitmapMode) const
-#In Constructors
-#Line # returns as Raster_Bitmap ##
-#Populate
-
-#Example
-#Image 4
-#Platform gpu
-    SkBitmap bitImage;
-    if (image->asLegacyBitmap(&bitImage, SkImage::kRO_LegacyBitmapMode)) {
-        canvas->drawBitmap(bitImage, 0, 0);
-    }
-    GrContext* grContext = canvas->getGrContext();
-    if (!grContext) {
-        return;
-    }
-    sk_sp<SkImage> textureImage(SkImage::MakeFromTexture(grContext, backEndTexture,
-                                kTopLeft_GrSurfaceOrigin, kRGBA_8888_SkColorType,
-                                kOpaque_SkAlphaType, nullptr));
-    canvas->drawImage(textureImage, 45, 45);
-    if (textureImage->asLegacyBitmap(&bitImage, SkImage::kRO_LegacyBitmapMode)) {
-        canvas->drawBitmap(bitImage, 90, 90);
-    }
-##
-
-#SeeAlso MakeRasterData makeRasterImage makeNonTextureImage
-
-#Method ##
-
-# ------------------------------------------------------------------------------
-
 #Method bool isLazyGenerated() const
 #In Property
 #Line # returns if Image is created as needed ##
diff --git a/docs/SkMemoryStream_Reference.bmh b/docs/SkMemoryStream_Reference.bmh
index 3bcbe67..b7e86b0 100644
--- a/docs/SkMemoryStream_Reference.bmh
+++ b/docs/SkMemoryStream_Reference.bmh
@@ -173,27 +173,6 @@
 
 # ------------------------------------------------------------------------------
 
-#Method void setMemoryOwned(const void* data, size_t length)
-#In incomplete
-#Line # incomplete ##
-
-#Private
-Internal use only.
-##
-
-#Param data  incomplete ##
-#Param length  incomplete ##
-
-#Example
-// incomplete
-##
-
-#SeeAlso incomplete
-
-#Method ##
-
-# ------------------------------------------------------------------------------
-
 #Method sk_sp<SkData> asData() const
 #In incomplete
 #Line # incomplete ##
diff --git a/docs/SkPaint_Reference.bmh b/docs/SkPaint_Reference.bmh
index 373be0e..98067ae 100644
--- a/docs/SkPaint_Reference.bmh
+++ b/docs/SkPaint_Reference.bmh
@@ -296,28 +296,6 @@
 #Line # glyph outline adjustment ##
 ##
 
-#Enum Hinting
-#Line # level of glyph outline adjustment ##
-
-#Code
-#Populate
-##
-
-#Const kNo_Hinting  0
-#Deprecated
-##
-#Const kSlight_Hinting  1
-#Deprecated
-##
-#Const kNormal_Hinting  2
-#Deprecated
-##
-#Const kFull_Hinting  3
-#Deprecated
-##
-
-##
-
 #Method void setHinting(SkFontHinting hintingLevel)
 #In Hinting
 #Line # sets Hinting, glyph outline adjustment level ##
@@ -334,26 +312,6 @@
     ##
 ##
 
-#Method Hinting getHinting() const
-#In Hinting
-#Line # returns Hinting, glyph outline adjustment level ##
-#Populate
-#NoExample
-##
-##
-
-#Method void setHinting(Hinting h)
-#In Hinting
-#Line # returns Hinting, glyph outline adjustment level ##
-#Populate
-#NoExample
-##
-##
-
-# Disable for now
-#ToDo no spelling errors
-###$ block comment
-
 #Method SkFontHinting getHinting() const
 #In Hinting
 #Line # returns Hinting, glyph outline adjustment level ##
@@ -370,9 +328,6 @@
     ##
 ##
 
-$$$# end of block comment
-#ToDo ##
-
 # ------------------------------------------------------------------------------
 #Subtopic Flags
 #Line # attributes represented by single bits ##
@@ -424,23 +379,6 @@
 
 #Enum ##
 
-#Enum ReserveFlags
-#Deprecated soon
-
-Only valid for Android framework.
-
-#Code
-#Populate
-##
-
-#Const kUnderlineText_ReserveFlag   0x0008
-#Deprecated soon
-##
-#Const kStrikeThruText_ReserveFlag  0x0010
-#Deprecated soon
-##
-##
-
 #Method uint32_t getFlags() const
 #In Flags
 #Line # returns Flags stored in a bit field ##
@@ -2893,11 +2831,6 @@
 
 ##
 
-#Method SkDrawLooper* getLooper() const
-#Bug 6259
-#Deprecated
-##
-
 #Method void setDrawLooper(sk_sp<SkDrawLooper> drawLooper)
 #In Draw_Looper_Methods
 #Line # sets Draw_Looper, multiple layers ##
@@ -2918,11 +2851,6 @@
 
 ##
 
-#Method void setLooper(sk_sp<SkDrawLooper> drawLooper)
-#Bug 6259
-#Deprecated
-##
-
 #Subtopic Draw_Looper_Methods ##
 
 #Subtopic Text_Size
@@ -3779,102 +3707,6 @@
 ##
 
 # ------------------------------------------------------------------------------
-#Subtopic Fast_Bounds
-#Line # approximate area required by Paint ##
-    #Private
-    To be made private.
-    ##
-
-Fast_Bounds functions conservatively outset a drawing bounds by additional area
-Paint may draw to.
-
-#Method bool canComputeFastBounds() const
-
-#In Fast_Bounds
-#Line # returns true if settings allow for fast bounds computation ##
-    #Private
-    (to be made private)
-    ##
-
-    Returns true if Paint does not include elements requiring extensive computation
-    to compute Device bounds of drawn geometry. For instance, Paint with Path_Effect
-    always returns false.
-
-    #Return  true if Paint allows for fast computation of bounds ##
-##
-
-#Method const SkRect& computeFastBounds(const SkRect& orig, SkRect* storage) const
-
-#In Fast_Bounds
-#Line # returns fill bounds for quick reject tests ##
-    #Private
-    (to be made private)
-    ##
-
-    Only call if canComputeFastBounds returned true. This takes a
-    raw rectangle, the raw bounds of a shape; and adjusts it for stylistic
-    effects in the paint, such as stroking. If needed, it uses the storage
-    parameter. It returns the adjusted bounds that can then be used
-    for SkCanvas::quickReject tests.
-
-    The returned Rect will either be orig or storage, thus the caller
-    should not rely on storage being set to the result, but should always
-    use the returned value. It is legal for orig and storage to be the same
-    Rect.
-
-    #Private
-    For example:
-    if (!path.isInverseFillType() && paint.canComputeFastBounds()) {
-        SkRect storage;
-        if (canvas->quickReject(paint.computeFastBounds(path.getBounds(), &storage))) {
-            return; // do not draw the path
-        }
-    }
-    // draw the path
-    ##
-
-    #Param orig     geometry modified by Paint when drawn ##
-    #Param storage  computed bounds of geometry; may not be nullptr  ##
-
-    #Return  fast computed bounds ##
-##
-
-#Method const SkRect& computeFastStrokeBounds(const SkRect& orig,
-                                              SkRect* storage) const
-#In Fast_Bounds
-#Line # returns stroke bounds for quick reject tests ##
-    #Private
-    (to be made private)
-    ##
-
-    #Param orig     geometry modified by Paint when drawn ##
-    #Param storage  computed bounds of geometry  ##
-
-    #Return  fast computed bounds ##
-##
-
-#Method const SkRect& doComputeFastBounds(const SkRect& orig, SkRect* storage,
-                                          Style style) const
-#In Fast_Bounds
-#Line # returns bounds for quick reject tests ##
-    #Private
-    (to be made private)
-    ##
-
-    Computes the bounds, overriding the Paint Style. This can be used to
-    account for additional width required by stroking orig, without
-    altering Style set to fill.
-
-    #Param orig     geometry modified by Paint when drawn ##
-    #Param storage  computed bounds of geometry  ##
-    #Param style    overrides Style ##
-
-    #Return  fast computed bounds ##
-##
-
-#Subtopic Fast_Bounds ##
-
-# ------------------------------------------------------------------------------
 #Subtopic Utility
 #Line # rarely called management functions ##
 ##
diff --git a/docs/SkPath_Reference.bmh b/docs/SkPath_Reference.bmh
index 3352832..11d0b53 100644
--- a/docs/SkPath_Reference.bmh
+++ b/docs/SkPath_Reference.bmh
@@ -4350,10 +4350,6 @@
 
 ##
 
-#Method bool pathRefIsValid() const
-#Deprecated soon
-##
-
 # ------------------------------------------------------------------------------
 
 #Class Iter
diff --git a/docs/SkPixmap_Reference.bmh b/docs/SkPixmap_Reference.bmh
index 1b38cc3..b012f34 100644
--- a/docs/SkPixmap_Reference.bmh
+++ b/docs/SkPixmap_Reference.bmh
@@ -177,12 +177,6 @@
 
 # ------------------------------------------------------------------------------
 
-#Method bool reset(const SkMask& mask)
-#Deprecated soon
-##
-
-# ------------------------------------------------------------------------------
-
 #Method bool extractSubset(SkPixmap* subset, const SkIRect& area) const
 
 #In Initialization
diff --git a/docs/SkRect_Reference.bmh b/docs/SkRect_Reference.bmh
index a776adc..fa34825 100644
--- a/docs/SkRect_Reference.bmh
+++ b/docs/SkRect_Reference.bmh
@@ -639,14 +639,7 @@
 
 #In As_Points
 #Line # returns four corners as Point ##
-Returns four points in quad that enclose Rect ordered as: top-left, top-right,
-bottom-right, bottom-left.
-
-#Private
-Consider adding param to control whether quad is clockwise or counterclockwise.
-##
-
-#Param quad  storage for corners of Rect ##
+#Populate
 
 #Example
     SkRect rect = {1, 2, 3, 4};
diff --git a/docs/SkRegion_Reference.bmh b/docs/SkRegion_Reference.bmh
index 7e72f6a..50ada67 100644
--- a/docs/SkRegion_Reference.bmh
+++ b/docs/SkRegion_Reference.bmh
@@ -1530,18 +1530,6 @@
 
 # ------------------------------------------------------------------------------
 
-#Method char* toString()
-#In Utility
-#Line # exists for Android framework only ##
-#Private
-Android framework only.
-##
-#Return string representation of Region ##
-
-#Method ##
-
-# ------------------------------------------------------------------------------
-
 #Method size_t writeToMemory(void* buffer) const
 #In Utility
 #Line # writes to buffer ##
diff --git a/docs/SkStream_Reference.bmh b/docs/SkStream_Reference.bmh
index a927639..c94b6f9 100644
--- a/docs/SkStream_Reference.bmh
+++ b/docs/SkStream_Reference.bmh
@@ -505,10 +505,6 @@
 
 Returns the starting address for the data. If this cannot be done, returns nullptr.
 
-#Private
-TODO: replace with virtual const SkData* getData()
-##
-
 #Return incomplete ##
 
 #Example
diff --git a/docs/SkSurface_Reference.bmh b/docs/SkSurface_Reference.bmh
index ee2e93f..32999c5 100644
--- a/docs/SkSurface_Reference.bmh
+++ b/docs/SkSurface_Reference.bmh
@@ -606,16 +606,7 @@
 #Method void notifyContentWillChange(ContentChangeMode mode)
 #In Miscellaneous
 #Line # notifies that contents will be changed outside of Skia ##
-Notifies that Surface contents will be changed by code outside of Skia.
-Subsequent calls to generationID return a different value.
-
-mode is normally passed as kRetain_ContentChangeMode.
-
-#Private
-Can we deprecate this?
-##
-
-#Param mode  one of: kDiscard_ContentChangeMode, kRetain_ContentChangeMode ##
+#Populate
 
 #Example
     auto surface = SkSurface::MakeRasterN32Premul(1, 1);
@@ -665,16 +656,6 @@
 Caller must overwrite the entire back-end object.
 ##
 
-#Const kFlushRead_TextureHandleAccess 0
-#Deprecated
-##
-#Const kFlushWrite_TextureHandleAccess 1
-#Deprecated
-##
-#Const kDiscardWrite_TextureHandleAccess 2
-#Deprecated
-##
-
 #NoExample
 // todo: need to update example to use GrBackendTexture instead of GrBackendObject
 #Platform gpu
@@ -1144,12 +1125,6 @@
 #Method ##
 
 # ------------------------------------------------------------------------------
-
-#Method void prepareForExternalIO()
-#Deprecated soon
-#Method ##
-
-# ------------------------------------------------------------------------------
 #Subtopic Utility
 #Line # rarely called management functions ##
 ##
diff --git a/docs/SkTextBlobBuilder_Reference.bmh b/docs/SkTextBlobBuilder_Reference.bmh
index 9ca937d..1e9fd92 100644
--- a/docs/SkTextBlobBuilder_Reference.bmh
+++ b/docs/SkTextBlobBuilder_Reference.bmh
@@ -196,27 +196,6 @@
 
 #Method ##
 
-# ------------------------------------------------------------------------------
-
-#Method const RunBuffer& allocRun(const SkPaint& font, int count, SkScalar x, SkScalar y,
-                              const SkRect* bounds = nullptr)
-#Deprecated
-#Method ##
-
-# ------------------------------------------------------------------------------
-
-#Method const RunBuffer& allocRunPosH(const SkPaint& font, int count, SkScalar y,
-                                  const SkRect* bounds = nullptr)
-#Deprecated
-#Method ##
-
-# ------------------------------------------------------------------------------
-
-#Method const RunBuffer& allocRunPos(const SkPaint& font, int count,
-                                 const SkRect* bounds = nullptr)
-#Deprecated
-#Method ##
-
 #Class SkTextBlobBuilder ##
 
 #Topic Text_Blob_Builder ##
diff --git a/docs/spelling.txt b/docs/spelling.txt
index 5d9075e..7caf9ef 100644
--- a/docs/spelling.txt
+++ b/docs/spelling.txt
@@ -35,7 +35,7 @@
 complexity complicated component components composed composite compositing composition

 compressed computation computations compute computed computes computing concatenated

 concatenates concatenation concave concert condensed condition configuration conical

-connect connected connecting connects consecutive conservative conservatively

+connect connected connecting connects consecutive conservative conservatively consider 

 consideration considered considers consistent consists const constant constants constrained

 constraint

 construct constructed constructing construction constructions constructor constructs

@@ -51,8 +51,8 @@
 

 dark darken darkening darker dashed dashes dashing debug decimal decimated declaring

 decode decoded decoders decodes decoding 

-decomposed decomposes decomposing decrease decreased decreases decreasing decrements default defaults

-defer deferred

+decomposed decomposes decomposing decrease decreased decreases decreasing decrements default

+defaults defer deferred

 defers define defined defines defining definition deform deformations degenerate degree

 degrees delete deleted deletes deleting dependent depending depends deprecated depth

 descent describe described describes describing description descriptions descriptor

@@ -76,7 +76,8 @@
 execution exhausted existing expanded expansion expected expecting explicit explicitly exponent

 exposed expression extend extended extends extension extensive extent extra extract eye 

 

-face faces factor factored factors fail failing fails failure fake fall false far fast faster fastest

+face faces factor factored factors fail failing fails failure fake fall false far fast faster

+fastest

 favor feature features fewer fidelity field fields figure file fill filled filling fills

 filter filtered filtering filters final finalized finally find fine finite first fit fits 

 fitted five fix

@@ -91,7 +92,8 @@
 good gradient gradients graphics gray gray-level greater greatest green grid grows guarantee

 guaranteed guard

 

-had hairline hairlines half half-precision halved hand handle handling hands happens hard hardware has hash

+had hairline hairlines half half-precision halved hand handle handling hands happens hard hardware

+has hash

 hashes have heap height help helper helpers helpful here hexadecimal hidden hierarchical

 high higher highest hint hinted hinting hints hit hitting hold holding holds hole holes

 horizontal horizontally host hosts hour how however hue hyperbola hyperbolic 

@@ -223,7 +225,8 @@
 those though thought thread threads three three-dimensional through thus tight tile

 tiles tiling time times

 to together toggled too top top-left top-right total totaling touches towards tracked tracks 

-trades trading traditional transferred transferring transfers transform transformation transformations

+trades trading traditional transferred transferring transfers transform transformation

+transformations

 transformed transforming transforms transition transitions translate translated translates

 translating translation translucent transparency transparent travel traveled treat treated

 treating treats triangle trigger triggered triggers trivial true try turned turns twice two

diff --git a/docs/undocumented.bmh b/docs/undocumented.bmh
index 2c5d965..68fdc4b 100644
--- a/docs/undocumented.bmh
+++ b/docs/undocumented.bmh
@@ -16,6 +16,7 @@
  malloc() calloc() assert() std::move()
  C C++ SIZE_MAX C_FILE FILE
  CSS HTML
+
  affine destructor multitexturing representable subclasses descender descenders grayscale kerning
  unhinted
  
diff --git a/docs/usingBookmaker.bmh b/docs/usingBookmaker.bmh
index 02256a2..a3413b2 100644
--- a/docs/usingBookmaker.bmh
+++ b/docs/usingBookmaker.bmh
@@ -107,25 +107,9 @@
 For instance, if the change was made to SkIRect, edit docs/SkIRect_Reference.bmh.
 Checking in the edited docs/SkIRect_Reference.bmh will fix the bot.
 
-If the interface is deprecated, but still present in the interface, mark-up the
-documentation to be deprecated as well.
-
-#Code
-###$
-#Method void someMethodThatIsNowDeprecated()
-#Deprecated
-##
-$$
-
-Use
-
-$Code
-#Deprecated soon
-$$
-
-if the change is soon to be deprecated.
-
-$$$#
+If the interface is deprecated, private, or experimental, documentation is not
+required. Put the word "Deprecated", "Private", or "Experimental"; upper or lower
+case, in a comment just before the symbol to be ignored.
 
 If
 #A Housekeeper-Nightly-Bookmaker # https://status.skia.org/repo/skia?filter=search&search_value=Housekeeper-Nightly-Bookmaker ##