On Sun, Aug 15, 2010 at 07:23:51PM -0400, Gaetan Nadon wrote: > In the hope of making it easier to learn. > This makefile may serve as a reference. > > Signed-off-by: Gaetan Nadon <mems...@videotron.ca> > --- > man/Makefile.am | 17 ++++++++++++----- > 1 files changed, 12 insertions(+), 5 deletions(-) > > diff --git a/man/Makefile.am b/man/Makefile.am > index b07da27..f1178d6 100644 > --- a/man/Makefile.am > +++ b/man/Makefile.am > @@ -23,6 +23,7 @@ > > libmandir = $(LIB_MAN_DIR) > > +# Source files for Input v2 man pages > XI2_txt = \ > XIChangeHierarchy.txt \ > XIDefineCursor.txt \ > @@ -39,6 +40,7 @@ XI2_txt = \ > XIListProperties.txt \ > XIChangeProperty.txt > > +# Source files for Input v1 man pages > libman_txt = \ > XAllowDeviceEvents.txt \ > XChangeDeviceDontPropagateList.txt \ > @@ -67,10 +69,12 @@ libman_txt = \ > XSetDeviceValuators.txt \ > $(XI2_txt) > > +# Name of DocBook XML files generated from .txt files by asciidoc > libman_xml = $(libman_txt:.txt=.xml) > -# manpages that are references to another page. These are produced as a > -# side effect of the xmlto rule, so they need to be handled specially. > > +# Shadow man pages are simply links to a main man page. > +# They are created by the xmlto command when generating man pages from > DocBook > +# The shadow man page contains a gtroff .so request to include the main man > page > XI2_shadows = \ > XIUndefineCursor.man \ > XIUngrabButton.man \ > @@ -107,6 +111,7 @@ libman_shadows = \ > $(XI2_shadows) > > > +# Name of man page files generated from DocBook XML files by xmlto > libman_PRE = $(libman_txt:.txt=.man) $(libman_shadows) > > if INSTALL_MANPAGES > @@ -117,7 +122,7 @@ EXTRA_DIST = $(libman_txt) $(libman_PRE) > CLEANFILES = $(libman_DATA) *.libmansuffix > MAINTAINERCLEANFILES = $(libman_PRE) *.xml > > -# prerequisites for the side effect pages > +# Dependencies for Input v1 shadow pages
please use X Input or XI here, not just Input. > XGetDeviceDontPropagateList.man: XChangeDeviceDontPropagateList.man > XChangeDeviceControl.man: XGetDeviceControl.man > XChangeDeviceKeyMapping.man: XGetDeviceKeyMapping.man > @@ -135,7 +140,7 @@ XGetDeviceFocus.man: XSetDeviceFocus.man > XChangeDeviceProperty.man: XGetDeviceProperty.man > XDeleteDeviceProperty.man: XGetDeviceProperty.man > > -# XI2 prereqs > +# Dependencies for Input v2 shadow pages same here. Cheers, Peter > XIUndefineCursor.man: XIDefineCursor.man > XIUngrabButton.man XIGrabKeycode.man XIUngrabKeycode.man: XIGrabButton.man > XIGetClientPointer.man: XISetClientPointer.man > @@ -151,6 +156,7 @@ XIFreeDeviceInfo.man: XIQueryDevice.man > XORGRELSTRING = $(PACKAGE_STRING) > XORGMANNAME = X Version 11 > > +# Unable to use __libmansuffix__ as underscores are lost in txt --> xml > conversion > MAN_SUBSTS = \ > -e 's/__xorgversion__/"$(XORGRELSTRING)" "$(XORGMANNAME)"/' \ > -e 's/__xservername__/Xorg/g' \ > @@ -163,6 +169,7 @@ SUFFIXES = .man .$(LIB_MAN_SUFFIX) > .man.$(LIB_MAN_SUFFIX): > $(SED) $(MAN_SUBSTS) < $< > $@ > > +# Generate man pages and shadow pages from .txt and then from DocBook XML > if HAVE_DOCTOOLS > SUFFIXES += .txt .xml > .txt.xml: > @@ -171,7 +178,7 @@ SUFFIXES += .txt .xml > $(XMLTO) man $< > mv -f $(@:.man=.libmansuffix) $@ > > -# need to force asciidoc/xmlto to run if necessary for side effect pages > +# Invoke asciidoc/xmlto main man page generation for shadow pages > $(libman_shadows): > @if test ! -f $(@:.man=.libmansuffix); then \ > rm -f $<; \ > -- > 1.6.0.4 > _______________________________________________ xorg-devel@lists.x.org: X.Org development Archives: http://lists.x.org/archives/xorg-devel Info: http://lists.x.org/mailman/listinfo/xorg-devel