[PATCH xkeyboard-config] Use XSL to generate man page from the rules XML

Gaetan Nadon gaetan.nadon at videotron.ca
Fri Jun 10 11:59:33 PDT 2011


On Fri, 2011-06-10 at 15:45 +1000, Peter Hutterer wrote:

> Generate a man-page from the evdev.xml through the xslt/man.xsl
> stylesheet.
> 
> Adds a requirement on the xorg util-macros and xsltproc.
> 
> Signed-off-by: Peter Hutterer <peter.hutterer at who-t.net>
> ---
> Taking this from a private thread to a public (archived!) list. Last
> argument of discussion was whether to distribute the man pages with
> the
> tarball or let the user build them (adding the requirement of xsltproc
> to
> build from the tarball). I don't care either way and Gaetan indicated
> that
> there are a few painful points when distributing generate man pages.
> So
> I say, screw it, let the users do it.
> 

Should there be a strong demand, we can model the code around libXi
which has gone through the bug fixing round. It would be worth writing a
test plan for this scenario. 


> This should be the patch then.
> 
>  Makefile.am     |    2 +-
>  configure.in    |   10 ++++
>  man/Makefile.am |   17 +++++++
>  man/man.xsl     |  133
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  4 files changed, 161 insertions(+), 1 deletions(-)
>  create mode 100644 man/Makefile.am
>  create mode 100644 man/man.xsl
> 
> 


I was going to suggest adding $(AM_V_GEN) to XSLTPROC, but the module
does not support silent rules, so instead I'll suggest removing it from
$(SED). It might prevent someone else waisting time finding out why it
does not work! When you get used to an environment...

Reviewed-by:  Gaetan Nadon <memsize at videotron.ca>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.x.org/archives/xorg-devel/attachments/20110610/1c3da7b2/attachment.htm>


More information about the xorg-devel mailing list