Re: [avr-libc-dev] HTML docs w/o JavaScript

[Joerg Wunsch]

As Theodore A. Roth wrote:

> :) Perhaps i'll also extend this to add <noframes> to the generated main
> :) page as well.
> 
> Can your perl script generate a table of contents? It would be relatively
> easy to add a link to the TOC in the header of each page.

It's something like a TOC, yes, though the formatting is currently
terrible.  However, this could probably be improved, though at the
price to not allow this to be rewritten in awk (since it will likely
only be possible by using some of the OO features of Perl).  Eric's
concert about Perl vs. awk was that awk is already there in his
Windows build environment, while Perl would add yet another tool to
the list of prerequisites for building the entire project.

Right now, i'm inserting the TOC between <noscript> and <noframes>
tags into tree.html, and index.html.  The script could easily also
generate a toc.html file out of this, which can then be referenced.

> I do agree that the JS tree sux. I'm not against just removing it from
> user view.

Well, while i normally hate JS a lot, what makes it nice here is that
the generated HTML and PDF resemble each other.  Having the TOC around
to the left makes it a bit easier to navigate, and to actually use it
as a reference document (IMHO).

> I mostly neutral on perl vs awk. They're both hideous to read (in my
> opinion ;-) but perl might be more widely used with repect to our
> user/developer base.

Well, i don't write Python. :)  The latter is something like a moot
point, since i doubt there will ever be more than one developer
maintaining that script. ;-)

I'll give it another try to improve the layout of the generated HTML
so it looks a bit nicer, and can be used as toc.html.
-- 
J"org Wunsch                                           Unix support engineer
address@hidden        http://www.interface-systems.de/~j/