GNOME Bugzilla – Bug 114456
integrate tool documentation
Last modified: 2004-12-22 21:47:04 UTC
gtk, glib and pango install a number of tools (glib-mkenums, gtk-query-immodules, gobject-query, etc). For some of these, we currently install man pages. I think it would be nice to add a "Tools" section to the api reference manuals and document the tools there. This would a) make it possible to link to the tools docs from other parts of the docs b) make it easier to maintain and complete the tools docs (no need to learn troff macros in addition to docbook tags) If manpages are still wanted, we can either try to get db2man to work for these or just add very short man pages referring to the api docs.
Here is a patch which implements the necessary autotools machinery and uses it for the gdk-pixbuf docs. It adds a new configure argument, --enable-man. The man pages will not be regenerated unless --enable-man is specified and the necessary tools (xsltproc and new enough docbook stylesheets) are found.
Created attachment 17415 [details] [review] patch
Created attachment 17416 [details] gdk-pixbuf-csource.xml
I've done this in HEAD.