Re: [docbook-apps] 1.78.1 manpages glitch?

[Paul DuBois <paul@kitebird.com>]

Thanks, Bob. I checked my man builds using the modified file and it seems to work fine.

On Jan 10, 2014, at 11:54 AM, Bob Stayton wrote:

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