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
b...@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-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org







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

Reply via email to