[ docbook-Bugs-1763332 ] man: stylesheet sorts tables before outputting troff

[SourceForge.net <no...@so...>]

Bugs item #1763332, was opened at 2007-07-30 11:04
Message generated for change (Comment added) made by xmldoc
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=373747&aid=1763332&group_id=21935

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: XSL
Group: output: manpages
>Status: Closed
Resolution: Fixed
Priority: 5
Private: No
Submitted By: kesuke (kesuke)
Assigned to: Michael(tm) Smith (xmldoc)
Summary: man: stylesheet sorts tables before outputting troff

Initial Comment:
Using Debian Unstable
Package: xsltproc
Version: 1.1.19-1
Architecture: i386

# xsltproc --version
Using libxml 20627, libxslt 10119 and libexslt 813
xsltproc was compiled against libxml 20627, libxslt 10119 and libexslt 813
libxslt 10119 was compiled against libxml 20627
libexslt 813 was compiled against libxml 20627

I create a man page from docbook source using the
command:

xsltproc -o manpage.1 /usr/share/xml/docbook/stylesheet/nwalsh/manpages/docbook.xsl
 manpage.xml

The docbook source contains a table, but the stylesheet
sorts the table before outputting the troff. To prevent
the sorting, i have to patch the stylesheet. The patch
is included as attachment. The patch is intended to
illustrate the location and the nature of the problem,
but it's not an actual fix because it might introduce
new problems. (I don't know the stylesheet language at
all.) I hope this is enough information, but you can
reach me at x...@re... for more.

----------------------------------------------------------------------

>Comment By: Michael(tm) Smith (xmldoc)
Date: 2007-08-06 19:20

Message:
Logged In: YES 
user_id=118135
Originator: NO

Fixed in r7177.

Please re-open this if you find that the fix does not work for you as
expected.

  --Mike

----------------------------------------------------------------------

Comment By: Michael(tm) Smith (xmldoc)
Date: 2007-08-06 19:19

Message:
Logged In: YES 
user_id=118135
Originator: NO

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/


----------------------------------------------------------------------

Comment By: Michael(tm) Smith (xmldoc)
Date: 2007-07-30 17:43

Message:
Logged In: YES 
user_id=118135
Originator: NO

Attached is a slightly modified version of your test file that illustrates
the case I was trying to handle through the sorting step in the manpages
stylesheet.

It just uses the "morerows" attribute on the row for number 12 as a way of
creating a rowspan so that there's only one single cell for "normal colour"
in the rows for numbers 12 and 13.

It's probably not a real-world case of how you'd want to actually want to
mark up this particular content, but I'm just sending it as a way of
showing what problem I'm trying to fix.

If I completely remove the sorting step, you can see the table output ends
up being borked. If do the sorting step the rowspan for those two rows gets
output as expected, but the side effect is that all the rows
unintentionally get sorted.

I'm not sure why that's happening, but I am sure I can fix it after
spending some time debugging it.

Anyway, thanks much for this bug report. I'll try to get this resolved as
soon as a I can.

  --Mike
File Added: infobash-with-morerows.xml

----------------------------------------------------------------------

Comment By: kesuke (kesuke)
Date: 2007-07-30 15:47

Message:
Logged In: YES 
user_id=1074830
Originator: YES

File Added: infobash.1

----------------------------------------------------------------------

Comment By: kesuke (kesuke)
Date: 2007-07-30 15:47

Message:
Logged In: YES 
user_id=1074830
Originator: YES

File Added: infobash.xml

----------------------------------------------------------------------

Comment By: Michael(tm) Smith (xmldoc)
Date: 2007-07-30 13:57

Message:
Logged In: YES 
user_id=118135
Originator: NO

Please post a copy of your DocBook XML source document (obfuscate it in
some way if it contains anything confidential). Also post a copy of the
generated man page (roff output), if possible.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=373747&aid=1763332&group_id=21935