melt-umn / copper

An integrated context-aware scanner and parser generator
http://melt.cs.umn.edu/copper
GNU Lesser General Public License v3.0
17 stars 4 forks source link

Document MDA and other advanced Copper features. #19

Open schwerdf opened 7 years ago

schwerdf commented 7 years ago

Currently, the Copper user manual covers only those features accessible from the CUP skin. Beyond what appears in the Javadoc and my thesis, the modular determinism analysis and other advanced features (parse table composition, etc.) are undocumented.

Attempts to produce this documentation in the past have been stymied by the fact that the features are only accessible through the XML skin and Java API, which were not meant to be used directly. However, if we regard the Javadoc for the grammarbeans package as suitably documenting the API, some usable documentation could be produced.