docbook-apps

  • 1.  1.78.1 manpages glitch?

    Posted 01-10-2014 16:44
    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>


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



  • 2.  Re: [docbook-apps] 1.78.1 manpages glitch?

    Posted 01-10-2014 17:54
    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>
    >
    >
    > </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'>
    >
    >


  • 3.  Re: [docbook-apps] 1.78.1 manpages glitch?

    Posted 01-13-2014 15:29
    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>
    >>
    >>
    >> </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'>
    >>
    >>