On 12/31/08, Barton Willis <willisb at unk.edu> wrote:
> Maybe because linsolve_by_lu isn't documented :( I must make a new years
> resolution ... Of course, just documenting linsolve_by_lu doesn't make
> the function easy find---our documentation needs more cross references
> (linsolve_by_lu, solve, linsolve, and algsys all reference each other).
Well, the documentation category system is supposed to address
the problem by getting all the items to point to a common location
(the category) where they're listed together.
The major defect in the existing category system is that the existing
in-Maxima documentation system (? and ??) can't follow links in
.info files, so there's no sense in generating the category links;
they're generated only for html output at present. (Although if someone
used the info program to browse, the links could be used there.)
Not sure what to do about that.
The category system might be improved by putting some per-category
exposition, or by putting in a 1-line summary of each item, or by
allowing nested categories.
best
Robert