proposal to begin tagging documentation with @category

Hello,

I am hoping to begin placing the @category macro in the
Maxima reference manual.

Until a scheme to generate the appropriate output is in place
(be it with scripts or Lisp programs or whatever, be it from
the Makefile or otherwise) the @category macro will expand
to nothing. (Eventually @category will expand to @ref for
html output, and nothing, probably, for plain text.)

I'll come up with a list of, say, a dozen initial categories
and proceed by marking all items appropriate for the first
one, all for the second, etc (instead of attempting to
proceed item by item and place all tags for an item at once).
Of course if anyone else wants to place @category tags
they are certainly welcome to do so.

I wonder if there is opposition to this plan, or ideas about
how to better complete it.

Robert Dodier

PS. A typical Texinfo item would look like this:

@deffn {Function} foo (@var{x})
Return the asymmetric frobnification of @var{x}.

@opencatbox
@category{Differential equations} @category{Numerical analysis}
@closecatbox
@end deffn

The @opencatbox, @category, and @closecatbox macros
would expand to nothing, until further notice.