Hello,
I have been tinkering with the documentation categories stuff again.
You can see the results, such as they are:
http://maxima.sourceforge.net/misc/tmp-categories-html/maxima_87.html
I believe that at this point the results are useful, and not too ugly.
Yes/no ?
The code is a menagerie of scripts. You can see them in cvs:
http://maxima.cvs.sourceforge.net/maxima/maxima/doc/info
Look for: category-macros.texi extract_categories1.awk
extract_categories1.sed extract_categories.sh
Maybe it would be better to implement this stuff by modifying texi2html
and/or makeinfo. At present I'm not planning to do that, although
maybe someone wants to talk me into it.
Given that the result is useful and not too ugly, I think it is worth
considering where to go from here. Here are some alternatives,
each of which involves some form of pain & suffering.
(1) Call current stuff from Makefile every time make is executed.
(2) Generate Texinfo file or files from @category tags
and commit in those so they don't have to generated from make.
(3) Rewrite stuff in Perl and/or Lisp in hopes of making
the category build process less obnoxious.
(4) Just forget the whole thing.
Comments?
Robert