Re: gEDA-user: command line options in the pcb manual

[DJ Delorie <dj@xxxxxxxxxxx>]

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
geda-user@xxxxxxxxxxxxxx
http://www.seul.org/cgi-bin/mailman/listinfo/geda-user