[Doc-SIG] Documentation systems for other languages

David Niergarth jdnier@execpc.com
Tue, 21 Dec 1999 07:56:57 -0600

Edward Welbourne wrote:

> Occam, specifically the *folding* idiom, as applied to docs in this
> case.  [Imagine, in a paper page on which your code is written, making
> sideways folds in the paper below each line of text; then you can hide a
> chunk of the page from view by concertina-ing up that bit of the page.]

I saw something similar at a presentation given by Peter Pierrou from
Excosoft at the recent Markup Technologies '99 conference. The prenentation
was titled Literate Programming in XML: Combining source code and
documentation. Apparently Excosoft uses this tool for all their internal
development work (including Python and 7-8 other languages). It's based on
their Documentor SGML/XML editor, which unfortunately is a commercial tool.
The paper is available at


in case anyone's interested.

This is a little off the topic of Fred's original question but maybe some
future free IDE for Python might incorporate the folding concept.

--David Niergarth