- I created a first draft of the nx language manual, based on the new next::doc facilities. It is still incomplete, but demonstrates the use of next::doc for authoring code documentation. To re-create the language reference (which is not yet integrated into the build environment), run:
./nextsh tests/doc.xotcl
You will then find an output directory "NextLanguageCore" in your /tmp/ directory. - The next::doc comments which are sourced for generating the manual can be found in generic/gentclAPI.decls and generic/predefined.xotcl. I tried to add most comments to the former, as the complexity of the predefined script does not comfort documentation comments (and vice versa). - Applied many fixes to the templates (based on the needs of the language reference)
- Adding basic support for subcommands (a @subcommand part type; formerly @variant) - Introducing comment reuse and cross-linkage along the class hierarchy upwards ("subclass of ...", showing inherited attributes and methods; using a @superclass attribute) - Amending the documentation of @param and @return with "type" information (checkoptions, constraints, defaults) - Showing both per-class and per-object methods - I now allow for inline- and out-of-line (block) code snippets in the description sections, based on wiki-like {{{...}}} marker annotation (same as in scaladoc2). - Adding support for newline representations in description sections (for a more convenient formatting). - Some bugfixes (e.g., @object-method did not work outside of an initcmd) - Started refactoring the entity tracing procedure (moving from [namespace import] resolution to mixin-based creation tracing)