Menu

#1245 step titles not output in man pages

output: manpages
closed-fixed
XSL (1066)
5
2012-11-07
2012-07-17
No

Step titles (procedure/step/title) are not rendered at all in man pages. In HTML, for example, they are, which is why I'm using them, and not seeing them in man pages loses a bit of information.

A simple solution is add something like this:

<xsl:template match="step/title">
<xsl:apply-templates/>
<xsl:text>: </xsl:text>
</xsl:template>

There are probably some more details that need to be dealt with for a general solution.

Discussion

  • Robert Stayton

    Robert Stayton - 2012-10-22

    A fix for this issue has been added to the current codebase.
    Please test the fix with the latest snapshot from:

    http://docbook.sourceforge.net/snapshots/

     
  • Robert Stayton

    Robert Stayton - 2012-10-22
    • assigned_to: nobody --> bobstayton
    • status: open --> pending-fixed
     
  • Peter Eisentraut

    I don't think this is a good solution. The rendering is inconsistent with the HTML output.

    HTML is

    1. title1

    text1

    2. title2

    text2

    New man page output would be:

    title1

    1. text1

    title2

    2. text2

    I think the latter is not very sensible by itself, and it doesn't reflect the hierarchy of XML elements, and there shouldn't be such grave inconsistencies between different formats.

     
  • Peter Eisentraut

    • status: pending-fixed --> open-fixed
     
  • Robert Stayton

    Robert Stayton - 2012-11-03

    I agree, the first solution was not consistent with the other outputs. I checked in another version that puts the title with the number.

     
  • Robert Stayton

    Robert Stayton - 2012-11-03
    • status: open-fixed --> pending-fixed
     
  • Peter Eisentraut

    • status: pending-fixed --> open-fixed
     
  • Peter Eisentraut

    It looks good now. Thanks.

     
  • Robert Stayton

    Robert Stayton - 2012-11-07
    • status: open-fixed --> closed-fixed