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: Re: [docbook-apps] Bug and Patch for broken soelim stub/ROFF links

I have not analyzed this code yet, but the SVN record shows that this source change occured 2010-08-20 in version r8865 by Mauritz Jeanson. Here is the comment:

"Modified the write.stubs template so that the section directory name is not output twice. Should fix bug #2831602. Also ensured that $lang is added to the .so path (when man.output.lang.in.name.enabled=1)."

The old #2831602 bug number mentioned in the comment is now #1058, and can be viewed here:


Perhaps you and Mauritz can discuss whether this patch is appropriate or not.

Bob Stayton
Sagehill Enterprises

From: "Thomas Schraitle" <tom_schr@web.de>
Sent: Monday, October 21, 2013 11:37 PM
To: <docbook-apps@lists.oasis-open.org>
Subject: [docbook-apps] 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

To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org

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