[libXi PATCH] Be smarter about generating man pages

Dan Nicholson dbn.lists at gmail.com
Tue Jan 13 05:40:40 PST 2009


On Mon, Jan 12, 2009 at 5:31 PM, Peter Hutterer
<peter.hutterer at who-t.net> wrote:
> On Tue, Dec 16, 2008 at 04:45:16PM -0800, Dan Nicholson 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.
>> ---
>>  man/.gitignore  |    2 +
>>  man/Makefile.am |  143 +++++++++++++++++++++++++++++--------------------------
>>  2 files changed, 77 insertions(+), 68 deletions(-)
>
> Late, but nonetheless. Pushed as 9911b7846ca2cedf08a963c84efe7907438975c1.
> Thanks for the patch.

Thanksl. What do you think about splitting up the XML?

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

--
Dan



More information about the xorg mailing list