[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
ftp://www.excosoft.se/pub/seminars/litprog.pdf
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