<div dir="ltr">This summer, Reid Mitchell (Pomona '16) put together an automatic document generation system for Grace, called GraceDoc.  It does not require any annotations on the part of the programmer.  Instead it uses simple rules to decide which comments go with declarations of types, classes, and public defs and variables.  If the programmer doesn't like the generated comments, they just have to tweak their comments a bit (typically just by adding or removing blank lines).<div><br></div><div>While there are lots of things that can be tweaked to make it better (e.g., the documentation for defs of objects with factory methods should look more like that for classes), I think it is quite usable.</div><div><br></div><div>It's not quite ready for distribution yet as it needs a slight variant of the parser and ast modules to associate comment nodes with the appropriate language constructs, but I did want to show off the results of Reid's work.</div><div><br></div><div>The generated documentation for the objectdraw library is at</div><div><a href="http://www.cs.pomona.edu/classes/cs051G/objectdrawdoc/">http://www.cs.pomona.edu/classes/cs051G/objectdrawdoc/</a><br></div><div><br></div><div>Kim</div></div>