Subject: proof-of-concept documentation category system
From: Robert Dodier
Date: Sun, 20 May 2007 14:53:52 -0600
Hello,
I've attempted to paste together a documentation category system for Texinfo.
I did that because there is not yet an existing category system sfaik.
Here is some example output. The list of categories is near the end of
this page.
http://maxima.sourceforge.net/misc/tmp-categories-html/tmp-target_toc.html
Categories are indicated in .texi files by @category tags which
are expanded into @ref tags by texi2html. A separate program
searches for @category tags and constructs a @node which
@ref's all the functions and variables which contain the @category.
The process is not completely automated at this point.
The whole thing is still kind of ugly but it's a start.
Btw here is an example of a working category system:
http://en.wikipedia.org/wiki/Jim_Jarmusch
(the list of categories is at the end of the article)
Comments?
Robert