OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Bug and Patch for broken soelim stub/ROFF links


some of my collegues found a strange (or better unexpected behaviour)
of the manpage output.

Between 1.75.2 and 1.76.1 the following change was added:

--- /tmp/docbook-xsl-1.75.2/manpages/other.xsl  2009-02-19
19:26:36.000000000 +0100
+++ /tmp/docbook-xsl-1.76.1/manpages/other.xsl  2013-10-21
09:53:07.719215407 +0200
@@ -595,10 +606,11 @@
           <xsl:with-param name="message-prolog">Note: </xsl:with-param>
           <xsl:with-param name="message-epilog"> (soelim
           <xsl:with-param name="content">
-            <xsl:value-of select="concat('.so man', $section, '/')"/>
+            <xsl:value-of select="'.so '"/>

This now leads to broken soelim/ROFF links. For example, if you have a
manpage foo(8) and transform your refentry document without further
parameters and customization, this leads to the following output:

.so foo.8

However, I was told this is wrong and would raise several problems
(security is one of them). The correct path should be:

.so man8/foo.8

After searching a bit, I've found a bug[2] entry in your DocBook
tracker. It seems quite similar.

I've played around and I could get the last output by setting the
parameters man.output.in.separate.dir to 1 and man.output.base.dir to
"".  Not sure why this is not the default. Any reasons?

Well, after more searching, I've found a patch in the Fedora stylesheet
package[2] which seems to be from the year 2011. I don't know why it is
not included. This patch does the "right thing" and outputs always the
correct path fragment.

Can we include this patch? Any further background information?

------ References
[1] https://sourceforge.net/p/docbook/bugs/1313/

    Thomas Schraitle

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]