[PATCH:libXi] Make shadow man pages generated by asciidoc work with Solaris man

[Gaetan Nadon]

On Thu, 2011-09-22 at 16:22 -0700, Alan Coopersmith wrote:

> On 09/22/11 15:16, Peter Hutterer wrote:
> > On Thu, Sep 22, 2011 at 08:51:01AM -0400, Gaetan Nadon wrote:
> >> On Thu, 2011-09-22 at 09:21 +1000, Peter Hutterer wrote:
> >>
> >>> I've gone ahead and merged this patch for now. It has the desired
> >>> effect on
> >>> my machine and until we figure out what's going on at least the
> >>> behaviour is
> >>> fixed. Once we know what exactly is causing this, we can revert the
> >>> patch.
> >>>
> >>>
> >>
> >> I could not find any bug description on the net that resembles what you
> >> have for asciidoc.
> >>
> >> You can send me your intermediate xml file produced so I can compare it
> >> to mine. At least we can distinguished if the problem is related to
> >> asciidoc or docbook xsl.
> >
> > Attached, this is with the standard F15 sciidoc-8.4.5-6.fc15.noarch
> 
> When I run xmlto man on that, I get XFreeDeviceList.libmansuffix that has:
> .so manlibmansuffix/XListInputDevices.libmansuffix
> 
> This is with these docbook packages:
> 
> NAME (PUBLISHER)                                        VERSION
> data/docbook/docbook-dtds (solaris)                     1.0
> data/docbook/docbook-style-dsssl (solaris)              1.79
> data/docbook/docbook-style-xsl (solaris)                1.75.2
> 
> (I think built from RHEL 6 srpms.)
> 


I get the same results with the same version of docbook-style-xsl you
have. In addition, for the Fedora version of XListInputDevices, I get a
bunch of warnings which I don't have with the Debian generated version:

        nadon at ubuntu:~/xorg/src/lib/libXi/man$ /usr/bin/xmlto man XListInputDevices-peter.xml
        Note: meta source : no *info/productname or alternative            XListInputDevices
        Note: meta source : see http://docbook.sf.net/el/productname       XListInputDevices
        Note: meta source : no refentry/refmeta/refmiscinfo at class=source   XListInputDevices
        Note: meta source : see http://docbook.sf.net/el/refmiscinfo       XListInputDevices
        Note: meta version: no *info/productnumber or alternative          XListInputDevices
        Note: meta version: see http://docbook.sf.net/el/productnumber     XListInputDevices
        Note: meta version: no refentry/refmeta/refmiscinfo at class=version  XListInputDevices
        Note: meta version: see http://docbook.sf.net/el/refmiscinfo       XListInputDevices
        Warn: meta source : no fallback for source, so inserted a fixme    XListInputDevices
        Note: meta manual : no titled ancestor of refentry                 XListInputDevices
        Note: meta manual : no refentry/refmeta/refmiscinfo at class=manual   XListInputDevices
        Note: meta manual : see http://docbook.sf.net/el/refmiscinfo       XListInputDevices
        Warn: meta manual : no fallback for manual, so inserted a fixme    XListInputDevices
        Warn: meta author : no refentry/info/author                        XListInputDevices
        Note: meta author : see http://docbook.sf.net/el/author            XListInputDevices
        Warn: meta author : no author data, so inserted a fixme            XListInputDevices
        Note: Writing XListInputDevices.libmansuffix
        Note: Writing XFreeDeviceList.libmansuffix (soelim stub)

The markup for the fedora file is different but does not seem to have an
impact on the final results. It may have an impact on Fedora if the
asciidoc/docbook-xsl version combination are too far apart in time.

Three sets of markup missing:

        <?asciidoc-toc?>
        <?asciidoc-numbered?>
        
        <refentryinfo>
            <title>XLISTINPUTDEVICES(libmansuffix)</title>
        </refentryinfo>
        
        <refmiscinfo class="source">&#160;</refmiscinfo>
        <refmiscinfo class="manual">&#160;</refmiscinfo>


Peter, how about you try the Debian generated xml on fedora?
Any local configuration of the tools involved?






-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.x.org/archives/xorg-devel/attachments/20110923/47b63459/attachment-0001.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: XListInputDevices.xml
Type: application/xml
Size: 10790 bytes
Desc: not available
URL: <http://lists.x.org/archives/xorg-devel/attachments/20110923/47b63459/attachment-0001.xml>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part
URL: <http://lists.x.org/archives/xorg-devel/attachments/20110923/47b63459/attachment-0001.pgp>