[libXi PATCH] Be smarter about generating man pages

Dan Nicholson dbn.lists at gmail.com
Thu Dec 18 09:59:55 PST 2008


On Tue, Dec 16, 2008 at 4:45 PM, Dan Nicholson <dbn.lists at gmail.com> wrote:
> With the current rules, the man pages will be generated repeatedly if you
> have xmlto installed. This is because make always thinks they are out of
> date with respect to their prerequisite, do_xmlto_stage. They are changed
> here to handle the multiple output files as described in the automake
> manual.
>
> distcheck has been confirmed to still work such that building from the
> tarball does not require xmlto. On the other hand, if the user wants to
> rebuild the man pages, they'll have to explicitly touch XI.xml.
>
> It may be better to split the xml into per-page files so that xmlto only
> generates one output at a time. A toplevel XI.xml can still pull together
> all the pieces with XInclude.

I decided to do the alternative and split up XI.xml into per-page
files. The make rules are still a little nasty to deal with xmlto
outputting multiple files, but I think this is cleaner. The patch has
a lot of churn, so here's a link:

http://people.freedesktop.org/~dbn/libXi-manpages.patch

--
Dan



More information about the xorg mailing list