Hi Bill,
Ralf's ALLPROSE (Aldor Literate Programming Support
Environemnt) http://www.hemmecke.de/aldor tool is intended
to be "a framework for building Aldor libraries and their
documentation". Clearly this framework could be extended for
use with the Axiom library with it's 1,300 tightly inter-
root <[EMAIL PROTECTED]> writes:
| >We have found that for a moderately large project (say over 10,000
| >lines of code) an outline (or even a set of outlines) is not enough.
| >We rely heavily on a LaTeX table of contents (our best analog to a Leo
| >outline), but we also rely on diagrams and ove
Norman Ramsey <[EMAIL PROTECTED]> writes:
| I have said for years that if you want better documentation, don't
| look to your tools---look to your *process*. The good news is that
| almost any kind kind of process will work: you just need multiple eyes
| to review the documents, and you need acco
>We have found that for a moderately large project (say over 10,000
>lines of code) an outline (or even a set of outlines) is not enough.
>We rely heavily on a LaTeX table of contents (our best analog to a Leo
>outline), but we also rely on diagrams and overview chapters.
>This is all very expensiv
On Tuesday, May 09, 2006 7:35 PM Norman Ramsey wrote:
> ...
> We have found that for a moderately large project (say over
> 10,000 lines of code) an outline (or even a set of outlines) is
> not enough. We rely heavily on a LaTeX table of contents (our
> best analog to a Leo outline), but we also re
> On Tuesday, May 09, 2006 4:38 PM Norman Ramsey wrote:
> > ...
> > I'm afraid you can have 'simple and understandable' or
> > you can have 'precise'. You can't have both. The man
> > page represents the usual muddled compromise that provides
> > neither.
>
> I don't mean for the followi