Uploaded image for project: 'Groovy'
  1. Groovy
  2. GROOVY-1713

Automated GLS documentation out of TCK test cases

    Details

    • Type: Task
    • Status: Closed
    • Priority: Major
    • Resolution: Won't Fix
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: Documentation
    • Labels:
      None

      Description

      JSR-241 contains three key deliverables:

      • RI: the Reference Implementation
      • GLS: the Groovy Language Specificatcion
      • TCK: the Test Compatibility Kit

      The GLS consists of:

      • the grammar and its diagrams (generated by Antlr from our Antlr grammar)
      • the specification explaining how the language works

      With an appropriate tree structure and with the aggregation of some html files, we could generate the specification out of the tests and those html files.
      The folder structure would create the outline of the whole document.

      It is a nice way of simplifying, automatically testing and automating the process of writing the Groovy Language Specification.

      This work can be hooked in the futher build process used to build distributions.

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                Unassigned
                Reporter:
                Guillaume Guillaume Delcroix
              • Votes:
                0 Vote for this issue
                Watchers:
                1 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: