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
Index: b/docbook-xsl/manpages/other.xsl
===================================================================
--- a/docbook-xsl/manpages/other.xsl 2016-07-20 01:39:45.756863640 +0200
+++ b/docbook-xsl/manpages/other.xsl 2016-07-20 01:39:45.752864399 +0200
@@ -560,7 +560,14 @@
<xsl:with-param name="message-prolog">Note: </xsl:with-param>
<xsl:with-param name="message-epilog"> (soelim stub)</xsl:with-param>
<xsl:with-param name="content">
- <xsl:value-of select="'.so '"/>
+ <xsl:choose>
+ <xsl:when test="$man.output.in.separate.dir = 0">
+ <xsl:value-of select="concat('.so man', $section, '/')"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select="'.so '"/> <!-- added case -->
+ </xsl:otherwise>
+ </xsl:choose>
<xsl:variable name="full.filename">
<xsl:call-template name="make.adjusted.man.filename">
<xsl:with-param name="name" select="$first.refname"/>
