<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 TRANSITIONAL//EN"> <HTML> <HEAD> <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=UTF-8"> <META NAME="GENERATOR" CONTENT="GtkHTML/3.32.2"> </HEAD> <BODY> On Fri, 2011-09-16 at 21:00 -0700, Alan Coopersmith wrote: <BLOCKQUOTE TYPE=CITE> <PRE> Solaris man requires .so entries in man pages include the man section directory, not just the man page filename, even when it's in the same directory, so use sed to add it in. Signed-off-by: Alan Coopersmith <<A HREF="mailto:alan.coopersmith@oracle.com">alan.coopersmith@oracle.com</A>> --- man/Makefile.am | 3 +++ 1 files changed, 3 insertions(+), 0 deletions(-) diff --git a/man/Makefile.am b/man/Makefile.am index d4c37b3..28211a1 100644 --- a/man/Makefile.am +++ b/man/Makefile.am @@ -159,6 +159,9 @@ MAN_SUBSTS += -e 's/libmansuffix/$(LIB_MAN_SUFFIX)/g' MAN_SUBSTS += -e 's/\[FIXME: source\]/$(XORG_MAN_PAGE)/' MAN_SUBSTS += -e 's/\[FIXME: manual\]/XINPUT FUNCTIONS/' +# asciidoc generates shadow page references without the man section directory +MAN_SUBSTS += -e 's/^\.so X/.so man$(LIB_MAN_SUFFIX)\/X/' + SUFFIXES = .man .$(LIB_MAN_SUFFIX) .man.$(LIB_MAN_SUFFIX): $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@ </PRE> </BLOCKQUOTE> On Debian, the patch is a noop. I see no difference in the generated shadow man pages. That would mean that what asciidoc or xmlto generates  is different on Solaris. The screen output of the test .so man page I used, after erasing *.man and *.3 and applying the patch: <BLOCKQUOTE> <PRE> <A HREF="mailto:nadon@ubuntu">nadon@ubuntu</A>:~/xorg/src/lib/libXi/man$ make XFreeDeviceList.3 cd .. && /bin/bash /home/nadon/xorg/src/lib/libXi/missing --run automake-1.11 --foreign man/Makefile cd .. && /bin/bash ./config.status man/Makefile config.status: creating man/Makefile /usr/bin/asciidoc -b docbook -d manpage -o XListInputDevices.xml XListInputDevices.txt /usr/bin/xmlto man XListInputDevices.xml Warn: meta author : no refentry/info/author                        XListInputDevices Note: meta author : see <A HREF="http://docbook.sf.net/el/author ">http://docbook.sf.net/el/author </A>           XListInputDevices Warn: meta author : no author data, so inserted a fixme            XListInputDevices Note: Writing XListInputDevices.libmansuffix Note: Writing XFreeDeviceList.libmansuffix (soelim stub) mv -f XListInputDevices.libmansuffix XListInputDevices.man mv -f XFreeDeviceList.libmansuffix XFreeDeviceList.man /bin/sed -e 's|__vendorversion__|"libXi 1.4.99" "X Version 11"|' -e 's|__xorgversion__|"libXi 1.4.99" "X Version 11"|' -e 's|__xservername__|Xorg|g' -e 's|__xconfigfile__|xorg.conf|g' -e 's|__projectroot__|/home/nadon/xorg/src/inst|g' -e 's|__apploaddir__||g' -e 's|__appmansuffix__|1|g' -e 's|__drivermansuffix__|4|g' -e 's|__adminmansuffix__|8|g' -e 's|__libmansuffix__|3|g' -e 's|__miscmansuffix__|7|g' -e 's|__filemansuffix__|5|g' -e 's/libmansuffix/3/g' -e 's/\[FIXME: source\]/X Version 11/' -e 's/\[FIXME: manual\]/XINPUT FUNCTIONS/' -e 's/^\.so X/.so man3\/X/' < XFreeDeviceList.man > XFreeDeviceList.3 rm XListInputDevices.xml </PRE> </BLOCKQUOTE> The content of the .man and .3 files: <BLOCKQUOTE> <PRE> .so manlibmansuffix/XListInputDevices.libmansuffix .so man3/XListInputDevices.3 </PRE> </BLOCKQUOTE> I attached the generated xml file in case. <BLOCKQUOTE> <PRE> I use asciidoc 8.6.3 and xmlto 0.0.23 xsltproc --version Using libxml 20708, libxslt 10126 and libexslt 815 xsltproc was compiled against libxml 20708, libxslt 10126 and libexslt 815 libxslt 10126 was compiled against libxml 20708 libexslt 815 was compiled against libxml 20708 </PRE> </BLOCKQUOTE> </BODY> </HTML>