<html>
  <head>
    <meta content="text/html; charset=ISO-8859-1"
      http-equiv="Content-Type">
  </head>
  <body bgcolor="#FFFFFF" text="#000000">
    <div class="moz-cite-prefix">On 14-04-16 10:57 AM, Hans de Goede
      wrote:<br>
    </div>
    <blockquote cite="mid:534E9A63.7090906@redhat.com" type="cite">
      <pre wrap="">Hi All,

In hw/xfree86/man/Makefile.am we now have:

include $(top_srcdir)/manpages.am
appman_PRE = Xorg.man
fileman_PRE = xorg.conf.man xorg.conf.d.man

if SUID_WRAPPER
appman_PRE += Xorg.wrap.man
fileman_PRE += Xwrapper.config.man
endif

And in manpages.am:
EXTRA_DIST = $(appman_PRE) $(driverman_PRE) $(fileman_PRE)

Normally automake automatically includes build-deps in
"make dist" even if they are in a if ... endif block.

But in this case since we conditionally modify a variable
and then use that in EXTRA_DIST it seems that make dist
is not including Xorg.wrap.man and Xwrapper.config.man
(as can been seen in the xorg-server-1.15.99.902 tarbals).

Any suggestions on how to fix this in a clean way ?</pre>
    </blockquote>
    <blockquote><tt>diff --git a/hw/xfree86/man/Makefile.am
        b/hw/xfree86/man/Makefile.am</tt><tt><br>
      </tt><tt>index f41d26c..5da404c 100644</tt><tt><br>
      </tt><tt>--- a/hw/xfree86/man/Makefile.am</tt><tt><br>
      </tt><tt>+++ b/hw/xfree86/man/Makefile.am</tt><tt><br>
      </tt><tt>@@ -5,4 +5,6 @@ fileman_PRE = xorg.conf.man
        xorg.conf.d.man</tt><tt><br>
      </tt><tt> if SUID_WRAPPER</tt><tt><br>
      </tt><tt> appman_PRE += Xorg.wrap.man</tt><tt><br>
      </tt><tt> fileman_PRE += Xwrapper.config.man</tt><tt><br>
      </tt><tt>+else</tt><tt><br>
      </tt><tt>+EXTRA_DIST += Xorg.wrap.man Xwrapper.config.man</tt><tt><br>
      </tt><tt> endif</tt><tt><br>
      </tt></blockquote>
    <br>
    In manpages.am:<br>
    <blockquote><tt># The calling Makefile should only contain man page
        targets</tt><tt><br>
      </tt><tt># Otherwise the following three global variables may
        conflict</tt><tt><br>
      </tt><tt>EXTRA_DIST = $(appman_PRE) $(driverman_PRE)
        $(fileman_PRE)</tt><tt><br>
      </tt><tt>CLEANFILES = $(appman_DATA) $(driverman_DATA)
        $(fileman_DATA)</tt><tt><br>
      </tt><tt>SUFFIXES = .$(APP_MAN_SUFFIX) .$(DRIVER_MAN_SUFFIX)
        .$(FILE_MAN_SUFFIX) .man</tt><tt><br>
      </tt></blockquote>
    We need to explicitly list files in EXTRA_DIST. We cannot use the
    built-in rules for man pages as they assume a hard-coded suffix
    (like .1 and so on).<br>
    <br>
    There is a problem in the content of the man page where the suffix
    is hard-coded. <br>
    <blockquote><tt>.TH Xorg.wrap 1 __xorgversion__</tt><br>
    </blockquote>
    should be:<br>
    <blockquote><tt>.TH Xorg.wrap __appmansuffix__ __xorgversion__</tt><br>
    </blockquote>
    as it is for Xorg.man<br>
    <br>
    <br>
    Xwrapper.config goes in the file section (usually 5, but not always).<br>
    It should be:<br>
    <blockquote><tt>.so man__appmansuffix__/Xwrapper.config.__appmansuffix__</tt><br>
    </blockquote>
    We have a man page for a "file" that is pointing to a man page for
    an "application".<br>
    <br>
    I am aware that section #1 is the same for all platforms, but it is
    the only one. All sections have been assigned a variable to have a
    common design which helps preventing other sections from being
    hard-coded.<br>
    <br>
    You can have a look at libXi for extensive use of .so man pages.
    Please double-check everything, it is error-prone.<br>
    <br>
    <blockquote cite="mid:534E9A63.7090906@redhat.com" type="cite">
      <pre wrap="">

Regards,

Hans
_______________________________________________
<a class="moz-txt-link-abbreviated" href="mailto:xorg-devel@lists.x.org">xorg-devel@lists.x.org</a>: X.Org development
Archives: <a class="moz-txt-link-freetext" href="http://lists.x.org/archives/xorg-devel">http://lists.x.org/archives/xorg-devel</a>
Info: <a class="moz-txt-link-freetext" href="http://lists.x.org/mailman/listinfo/xorg-devel">http://lists.x.org/mailman/listinfo/xorg-devel</a>

</pre>
    </blockquote>
    <br>
  </body>
</html>