Subject: proof-of-concept documentation category system
From: Vadim V. Zhytnikov
Date: Mon, 21 May 2007 15:32:54 +0300
Robert Dodier writes:
> 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.
>
I like the concept and think that it is "must have"
new feature to next releases of Maxima manual but
exact list of valid categories requires serious
consideration. Are categories one-level object
or we can have categories with subcategories etc?
--
Vadim V. Zhytnikov
<vvzhy at mail.ru>
<vvzhy at netorn.ru>