I don't like the idea of having to manually code numbers for sort
sequences in order to keep HIDs sorted alphabetically:
/* %start-doc options "11 Top Window Options"
I would much rather put a sortable key in there instead:
/* %start-doc options "Top Window Options" GTK
Or, you could extend extract-docs to accept hierarchical categories:
/* %start-doc options::gtk "Top Window Options"
But elsewhere you'd have to have something that maps the sub-category
to a texinfo division:
%category options::gtk GTK Options
Alternately, and probably a lot simpler, extract to multiple files:
/* %start-doc options-gtk listen
@item --listen
Listen for actions on stdin.
%end-doc
and have each HID code for its own include:
/* %start-doc options gtk
@subsection GTK Command Line Options
@ftable @code
@include options-gtk.texi
@end ftable
@end subsection
%end-doc */
Also note that you should not use one @ftable for each @item, you
should have one @ftable/@end enclosing the whole list of @item's.
_______________________________________________
geda-user mailing list
[email protected]
http://www.seul.org/cgi-bin/mailman/listinfo/geda-user
