Format cribbed from YARD method and attribute summary blocks. Still some work to do, but initial results don't look that bad.
Basically a straight port of the logic from the YARD template for Ruby classes.