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

[Peter Hutterer]

On Fri, Sep 23, 2011 at 08:45:16AM -0400, Gaetan Nadon wrote:
> 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?

:: whot at barra:~/Download> xmlto man XListInputDevices.xml 
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)

:: whot at barra:~/Download> cat XFreeDeviceList.libmansuffix 
.so XListInputDevices.libmansuffix

Cheers,
  Peter