Page 11 : 40
Elucidative Programming
* Introduction
Where is Denmark?
Where is Aalborg?
Plan of this talk
Introduction
Kinds of understanding
Which kind of documentation
Views on documentation
Integrated program documentation
* Literate Programming
Literate Programming and the WEB System
An example of a literate program
Internal structure of a literate program (1)
Internal structure of a literate program (2)
The WEB tools for literate programming
Problems with WEB-like literate programming
* Elucidative Programming
The meaning of the word
Elucidative Programming
Requirements
An example of an elucidative program
More examples of elucidative programs
The elucidative programming model
The source format of the documentation - Scheme
Tool Overview
The elucidator tool
The editor tool
The browser tool
Tool Integration
Tool philosophy
Integration with LAML SchemeDoc
A broader perspective on the use of an elucidator
Program Evolution
* Experience
Industrial experience
Industrial quotes
* Status and Conclusions
Status and Conclusions
* Further Information
Web resources about Elucidative Programming
Literate Programming and the WEB System
Here we will briefly describe an important background and inspiration, namely Knuth's ideas of literate programming.
Knuth invented literate programming in order to explain and publish his programs in articles and books
Characteristics of literate programming:
Detachment of
program explanation structure
from
program structure
The
proximity
between program fragments and their explanations
The pieces of program 'live in' the documentation
The opposite approach of conventional program commenting
Literate programming is typically supported by tools in the WEB-family
![Previous page: Literate Programming [Section] -- Keyboard shortcut: 'p'](./images/nav-left.gif "Previous page: Literate Programming [Section] -- Keyboard shortcut: 'p'")
