Over the last three years we at MPE Forth have switched over to a tool chain (Forth) which extracts documentation as formal comments from the source code and then generates HTML
and/or PDF manuals. The effect of this has been to encourage our own programmers and our clients to write the documentation as the code is written.
When we looked at literate programming tools some years ago, the problem was that the source for the compiler and the documentation could get out of step. In our system there is only ever one file, and the documentation is contained within formal comments.
Stephen Pelc, [email protected]