- Observations about the Scheme elucidator:
- Basically, we address Scheme define forms from the documentation side
- Not arbitrary program fragments as in WEB-like literate programming
- In Scheme it is possible to have program elements outside abstractions
- Only relevant for imperative programming
- How are these addressed from the documentation?
- The solution: Sectional comments which names the form(s) following the comment
- Lexical comments cause problems in the abstraction process
- Not only in Scheme, but almost in every programming language
- We apply a preprocessor which transform all lexical comments to syntactical comments
| | |