Re: [docbook-apps] 1.78.1 manpages glitch?

[Bob Stayton <bobs@sagehill.net>]

Hi Paul,
Yes, that bug regarding certain line endings was reported and fixed 
after the release of 1.78.1.  The latest XSL snapshot works as expected. 
 The fixed file is manpages/utility.xsl and the fixed template in that 
file is named "mixed-block".

http://snapshots.docbook.org/

--
Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

On 1/10/2014 8:44 AM, Paul DuBois wrote:
> I'm noticing a difference in manpage production with 1.78.0 versus 1.78.1.
>
> Consider this input:
>
>          <listitem>
>            <para>
>              <indexterm significance="normal">
>                <primary>mysql-stress-test.pl</primary>
>                <secondary>help option</secondary>
>              </indexterm>
>
>              <indexterm significance="normal">
>                <primary>help option</primary>
>                <secondary>mysql-stress-test.pl</secondary>
>              </indexterm>
>
>              <option>--help</option>
>            </para>
>
>            <para>
>              Display a help message and exit.
>            </para>
>          </listitem>
>
> 1.78.0 output is okay, with the <indexterm> elements written as groff comments terminated by newlines
>
> .RS 4
> .ie n \{\
> \h'-04'\(bu\h'+03'\c
> .\}
> .el \{\
> .sp -1
> .IP \(bu 2.3
> .\}
> .\" mysql-stress-test.pl: help option
> .\" help option: mysql-stress-test.pl
> \fB\-\-help\fR
> .sp
> Display a help message and exit\&.
> .RE
>
> 1.78.1 output loses the newlines after the indexterm elements. The result is that the option
> value (\fB\-\-help\fR) is glued onto the end of the long comment line. So of course it disappears
> from the output of nroff -man and the resulting man page doesn't show the option. :-)
>
> .RS 4
> .ie n \{\
> \h'-04'\(bu\h'+03'\c
> .\}
> .el \{\
> .sp -1
> .IP \(bu 2.3
> .\}
> .\" mysql-stress-test.pl: help option.\" help option: mysql-stress-test.pl\fB\-\-help\fR
> .sp
> Display a help message and exit\&.
> .RE
>
> The only manpages difference I see between 1.78.0 and 1.78.1 occurs here:
>
> --- /Users/..xxx.../docbook-xsl-1.78.0/manpages/utility.xsl	2014-01-10 10:30:29.000000000 -0600
> +++ ./utility.xsl	2014-01-10 10:32:21.000000000 -0600
> @@ -7,7 +7,7 @@
>                  version='1.0'>
>
> <!-- ********************************************************************
> -     $Id: utility.xsl 9652 2012-10-26 22:44:46Z bobstayton $
> +     $Id: utility.xsl 9703 2013-01-07 20:13:05Z bobstayton $
>       ********************************************************************
>
>       This file is part of the XSL DocBook Stylesheet distribution.
> @@ -306,7 +306,7 @@
>                      or following-sibling::node()[1][self::processing-instruction()]
>                      ">
>              <xsl:if test="normalize-space($content) != ''
> -                          or concat(normalize-space($content), ' ') = ' '">
> +                          or concat(normalize-space($content), ' ') != ' '">
>                <xsl:text>&#10;</xsl:text>
>              </xsl:if>
>            </xsl:if>
>
> If I change the 1.78.1 utility.xsl comparison from != to the = comparison used in 1.78.0, the output reverts to the correct form (with newlines included).
>
> I see no other difference in the output.
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org