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: 1.78.1 manpages glitch?


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.


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