Re: [docbook-apps] Bug and Patch for broken soelim stub/ROFF links

["Bob Stayton" <bobs@sagehill.net>]

Hi,
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:

  https://sourceforge.net/p/docbook/bugs/1058/

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

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

--------------------------------------------------
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

> Hi,
>
> 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
> stub)</xsl:with-param>
>           <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/
> [2]
> http://pkgs.fedoraproject.org/cgit/docbook-style-xsl.git/tree/docbook-xsl-mandir.patch
>
>
> --
> Gruß/Regards,
>    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