Menu

#834 ".sp" in manpages instead of paragraph separator

output: manpages
closed-fixed
XSL (1066)
5
2006-10-28
2006-10-12
No

Manpages generated by xsltproc contain ".sp" throughout
the document where there should be paragraph breaks.

Affected manpages were generated with Debian packages.

Here is how the generation was invoked including the
output:

<quote>
$ xmlto -vv man ccontrol.1.xml
Format script: /usr/share/xmlto/format/docbook/man
Convert to troff
Real stylesheet:
http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
xmllint >/dev/null --xinclude --postvalid
/tmp/ccontrol.1.xml
Stylesheet: /tmp/xmlto-xsl.zF5486
xsltproc --nonet --xinclude \ -o /tmp/xmlto.HC5490/ccontrol.1.proc \ /tmp/xmlto-xsl.zF5486 \ /tmp/ccontrol.1.xml
Note: meta manvol : No manvolnum
ccontrol
Note: meta date : No date. Using generated date
ccontrol
Note: meta source : No productname or alternative
ccontrol
Note: meta source : No refmiscinfo@class=source
ccontrol
Note: meta version: No productnumber or alternative
ccontrol
Note: meta version: No refmiscinfo@class=version
ccontrol
Warn: meta source : No valid fallback. Leaving empty
ccontrol
Note: meta manual : No ancestor with title
ccontrol
Note: meta manual : No refmiscinfo@class=manual
ccontrol
Warn: meta manual : No valid fallback. Leaving empty
ccontrol
Note: Writing ccontrol.1
</quote>

Package versions used were:
docbook-xsl 1.71.0.dfsg.1-1
xml-core 0.09-0.1
docbook-xml 4.4-5
docbook-xsl-doc 1.71.0.dfsg.1-1
xsltproc 1.1.17-5

Discussion

  • Ted Percival

    Ted Percival - 2006-10-12

    example input

     
  • Ted Percival

    Ted Percival - 2006-10-12

    Logged In: YES
    user_id=1011928

    It might be obvious to point out that the output is
    formatted properly if newlines are manually inserted in
    front of the ".sp" in each case.

    Attached is the output I get with the given (already
    attached) example input.

     
  • Ted Percival

    Ted Percival - 2006-10-12

    output from example input

     
  • Michael(tm) Smith

    • assigned_to: nobody --> xmldoc
     
  • Michael(tm) Smith

    Logged In: YES
    user_id=118135

    I was able to reproduce this. Thanks for reporting it.
    It appears to be a bug in simpara handling (works
    fine if you use para instead).

    Anyway, I will get a fix checked in asap.

    --Mike

     
  • Michael(tm) Smith

    Logged In: YES
    user_id=118135

    I made a very simple fix -- so that that a newline is
    always output after simpara content and before the .sp that
    marks the end of it. It might possibly result in extra
    lines of space in other contexts; I'll need to test a
    little more and come up with something smarter if it does
    turn out that this simple fix causes extra blank lines.

    Anyway, this should fix the problem you reported. if it
    doesn't, or if you find that it causes other problems,
    please re-open this bug.

     
  • Michael(tm) Smith

    Logged In: YES
    user_id=118135

    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/

     
  • Michael(tm) Smith

    • status: open --> pending-fixed
     
  • Ted Percival

    Ted Percival - 2006-10-28

    Logged In: YES
    user_id=1011928

    Seems to work perfectly, thank you. Tested with
    SNAPSHOT_2006-10-26 with unique ID E1Gd0NS-00080B-0p.

     
  • Ted Percival

    Ted Percival - 2006-10-28
    • status: pending-fixed --> open-fixed
     
  • Ted Percival

    Ted Percival - 2006-10-28
    • status: open-fixed --> closed-fixed
     
  • Michael(tm) Smith

    Logged In: YES
    user_id=118135

    Thanks for the follow-up. Closing as Fixed.