From: Jonathan Turkanis (technews_at_[hidden])
Date: 2004-10-04 14:38:39
"Caleb Epstein" <caleb.epstein_at_[hidden]> wrote in message
> On Sun, 3 Oct 2004 13:46:22 -0600, Jonathan Turkanis
> <technews_at_[hidden]> wrote:
> > The really big problem is that the HTML for the index, which can be rather
> > large, would be physically included in each content page. This could make
> > library documentation enormous.
> What about a middle ground? The index can live in its own frame to
> prevent this duplication of code, but there could be some level of
> navigation available on each page (e.g. prev/next/up/down links).
> This way folks who dislike or can't view frames can still find their
> way around.
This is what I favor for automatically generated documentation. It doesn't work
for handwritten docs, since adding the prev/next/up/down is 'tedious and error
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk