wip
Hah!  The protocol buffer compiler has a bug due to
regex catestrophic backtracking while parsing long comments.  Work around
by moving docs to their own markdown file...