skia2/docs
Cary Clark 2be81cf973 Condense embedded formulas.
Bookmaker delimits formulas and equations to allow
representing variables and symbols without tripping
up reference lookup, spell checking, and comment
generation.

Before, formulas were represented with:
some text
#Formula
(x + y, 0)
##
, and more text

This made it difficult to know when spacing should
be preserved before and after the formula. Now,
formulas are represented with:
some text #Formula # (x + y, 0) ##, and more text

The presence or absence of a space between ## and ,
is now significant (before it was not).

Also, formulas are bracketed by <code> in markdown
generation, so that variables stand out better.
See:
https://skia.org/user/api/SkBlendMode_Reference?cl=152781#Dst_Out
for an example.

Also fixed 100 column offenders and added a code
check to identify them. For the moment, 100 column
offenders are outed with SkDebugf but their presence
does not cause bookmaker to fail.

TBR=caryclark@google.com

Docs-Preview: https://skia.org/?cl=152781
Bug: skia:6898
Change-Id: If92a65a234f5d616bf4485984a8d219a6f04821a
Reviewed-on: https://skia-review.googlesource.com/152781
Commit-Queue: Cary Clark <caryclark@skia.org>
Auto-Submit: Cary Clark <caryclark@skia.org>
Reviewed-by: Cary Clark <caryclark@skia.org>
2018-09-13 16:50:25 +00:00
..
catalogHeader.txt Documentation refresh 2018-05-16 11:35:24 +00:00
catalogTrailer.txt streamline doc menus 2017-11-01 14:23:50 +00:00
illustrations.bmh deprecate draw text on path in docs 2018-08-28 16:22:53 +00:00
markup.bmh Documentation refresh 2018-05-16 11:35:24 +00:00
overview.bmh bookmaker initial checkin 2017-07-28 15:30:38 +00:00
SkAutoCanvasRestore_Reference.bmh Documentation refresh 2018-05-16 11:35:24 +00:00
SkBitmap_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkBlendMode_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkCanvas_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkColor4f_Reference.bmh bookmaker report only changed files 2018-08-28 19:42:20 +00:00
SkColor_Reference.bmh simplify confusing examples 2018-06-19 19:51:19 +00:00
SkDynamicMemoryWStream_Reference.bmh new batch of docs 2018-08-10 17:44:46 +00:00
SkFILEStream_Reference.bmh new batch of docs 2018-08-10 17:44:46 +00:00
SkFILEWStream_Reference.bmh new batch of docs 2018-08-10 17:44:46 +00:00
SkImage_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkImageInfo_Reference.bmh fix doc catalog 2018-06-28 13:18:16 +00:00
SkIPoint_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkIRect_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkMatrix_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkMemoryStream_Reference.bmh new batch of docs 2018-08-10 17:44:46 +00:00
SkPaint_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkPath_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkPicture_Reference.bmh new batch of docs 2018-08-10 17:44:46 +00:00
SkPixmap_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkPoint_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkRect_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkRegion_Reference.bmh reland fix picture subclass destructor doc 2018-09-07 19:09:26 +00:00
SkRRect_Reference.bmh new batch of docs 2018-08-10 17:44:46 +00:00
SkStream_Reference.bmh new batch of docs 2018-08-10 17:44:46 +00:00
SkSurface_Reference.bmh Condense embedded formulas. 2018-09-13 16:50:25 +00:00
SkTextBlob_Reference.bmh fix text blob example errors 2018-08-10 19:56:03 +00:00
SkTextBlobBuilder_Reference.bmh new batch of docs 2018-08-10 17:44:46 +00:00
SkWStream_Reference.bmh new batch of docs 2018-08-10 17:44:46 +00:00
status.json new batch of docs 2018-08-10 17:44:46 +00:00
undocumented.bmh added optimizations to speed up skinning 2018-08-15 15:52:29 +00:00
usingBookmaker.bmh bookmaker self documentation 2018-09-06 17:11:23 +00:00