[xml/sgml-pkgs] Bug#831831: Creates broken so links

[Michael Biebl]

Package: docbook-xsl
Version: 1.79.1+dfsg-1
Severity: normal
File: /usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/other.xsl
Tags: patch

Hi,

when building the man pages for systemd, which use docbook-xml, I get
the following warning:

E bad-so-link-within-manual-page
usr/share/man/man1/init.1.gz

Manual files that use the .so links to include other pages should only
point to a path relative to the top-level manual hierarchy, e.g.

.so man3/boo.1.gz


I first this as a systemd upstream issue [1], but they told me that this
is actually a XML/XSL toolchaing issue in Debian which should be fixed.

Fedora ships the patch from [2] with some more background on the patch
at [3]. I've attached the patch for your convenience.
I've verified that with the patch applied, the generated init man page
in systemd is fixed.

Please consider applying the same patch to the Debian package.

Thanks,
Michael


[1] https://github.com/systemd/systemd/issues/3412
[2] http://pkgs.fedoraproject.org/cgit/rpms/docbook-style-xsl.git/tree/docbook-xsl-mandir.patch
[3] https://bugzilla.redhat.com/show_bug.cgi?id=%23727251

-- System Information:
Debian Release: stretch/sid
  APT prefers unstable-debug
  APT policy: (500, 'unstable-debug'), (500, 'unstable'), (200, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.6.0-1-amd64 (SMP w/4 CPU cores)
Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages docbook-xsl depends on:
ii  xml-core  0.13+nmu2

Versions of packages docbook-xsl recommends:
ii  docbook-xml  4.5-7.3

Versions of packages docbook-xsl suggests:
pn  dbtoepub                                <none>
ii  docbook-xsl-doc-html [docbook-xsl-doc]  1.78.1-1
pn  docbook-xsl-saxon                       <none>
pn  fop                                     <none>
pn  libsaxon-java                           <none>
ii  libxalan2-java                          2.7.1-9
pn  libxslthl-java                          <none>
pn  xalan                                   <none>

-- no debconf information
-------------- next part --------------
A non-text attachment was scrubbed...
Name: docbook-xsl-mandir.patch
Type: text/x-diff
Size: 1056 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/debian-xml-sgml-pkgs/attachments/20160720/6fd3151c/attachment.patch>