ENG-7213: Fill in the Table annotation used by the catalog report
generator with the canonical DDL for the table.
ENG-7213: Add some more commentary to compensate for a bad interface.
Merge pull request #1897 from VoltDB/eng7213

ENG-7213: Fill in the Table annotation used by the catalog report, r=scooper