How to use the Bookmaker utility.
Get the fiddle command line interface tool.
$ go get go.skia.org/infra/fiddle/go/fiddlecli
$ ninja -C out/dir bookmaker
$ ./out/dir/bookmaker -t -i include/core/SkXXX.h
Generate fiddle.json from all examples, including the ones you just wrote. Error checking is syntatic: starting keywords are closed, keywords have the correct parents. If you run Bookmaker inside Visual Studio, you can click on errors and it will take you to the source line in question.
$ ./out/dir/bookmaker -e fiddle.json -b docs
Once complete, run fiddlecli to generate the example hashes. Errors are contained by the output but aren’t reported yet.
$ $GOPATH/bin/fiddlecli --input fiddle.json --output fiddleout.json
Generate bmh SkXXX.md from SkXXX.bmh and fiddleout.json. Error checking includes: undefined references, fiddle compiler errors, missing or mismatched printf output. Again, you can click on any errors inside Visual Studio.
$ ./out/dir/bookmaker -r site/user/api -b docs -f fiddleout.json
The original include may have changed since you started creating the markdown. Check to see if it is up to date. This reports if a method no longer exists or its parameters have changed.
Generate an updated include header. This writes the updated SkXXX.h to the current directory.
$ ./out/dir/bookmaker -p -b docs -i include/core/SkXXX.h
Bookmaker bugs are trackedherebug.skia.org/6898.