[xml/sgml-pkgs] Bug#516165: docbook2x: Broken section transitions

[Tim]

Package: docbook2x
Version: 0.8.8-8
Severity: important


Hello,

I develop a package which distributes man pages and I use docbook XML to
accomplish this.  In my release build scripts, I run the following to
create the man pages:
  docbook2x-man --to-stdout reglookup.1.docbook > man/man1/reglookup.1
  ...
  cd man/man1 && gzip -9 -f reglookup.1

Lately I've noticed that there hare display problems in some of the
output.  Specifically, the section transition between my SYNOPSIS block
and DESCRIPTION block is broken when I run `man reglookup'.  Here's what
I see on screen:

-------------------------------------8<-----------------------------------
SYNOPSIS
       reglookup  [options] registry-file .SH DESCRIPTION reglookup is
       designed to read windows registry elements and print them out to
       stdout in a CSV-like format. It has filtering options to narrow
       the focus of the output. This tool is designed to work with on
       Windows NT-based registries. 
------------------------------------->8-----------------------------------


But it should read:

-------------------------------------8<-----------------------------------
SYNOPSIS
       reglookup  [options] registry-file

DESCRIPTION 
       reglookup is designed to read windows registry elements and print
       them out to stdout in a CSV-like format. It has filtering options
       to narrow the focus of the output. This tool is designed to work
       with on Windows NT-based registries.
------------------------------------->8-----------------------------------

This block corresponds to a docbook file (start of file to end of
description block included):

-------------------------------------8<-----------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<refentry id='reglookup.1'>
  <!--  $Id: reglookup.1.docbook 138 2009-02-08 19:53:48Z tim $ -->
  <refmeta>
    <refentrytitle>reglookup</refentrytitle>
    <manvolnum>1</manvolnum>
    <refmiscinfo class="sectdesc">File Conversion Utilities</refmiscinfo>
  </refmeta>
  <refnamediv id='name'>
    <refname>reglookup</refname>
    <refpurpose>Windows NT+ registry reader/lookup tool</refpurpose>
  </refnamediv>

  <refsect1 id='synopsis'>
    <title>SYNOPSIS</title>
    <para>
      <command>
        reglookup [options] <replaceable>registry-file</replaceable>
      </command> 
    </para>
  </refsect1>

  <refsect1 id='description'>
    <title>DESCRIPTION</title>
    <para>
        reglookup is designed to read windows registry elements and
        print them out to stdout in a CSV-like format.  It has filtering
        options to narrow the focus of the output.  This tool is
        designed to work with on Windows NT-based registries.
    </para>
  </refsect1>
------------------------------------->8-----------------------------------

In looking at the output generated by docbook2x-man, I see:


-------------------------------------8<-----------------------------------
'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH reglookup 1 "19 February 2009" "File Conversion Utilities" ""
.SH NAME
reglookup \- Windows NT+ registry reader/lookup tool
.SH SYNOPSIS
\fBreglookup [options] \fIregistry-file\fB
\fR.SH DESCRIPTION
reglookup is designed to read windows registry elements and
print them out to stdout in a CSV-like format. It has filtering
options to narrow the focus of the output. This tool is
designed to work with on Windows NT-based registries.
------------------------------------->8-----------------------------------

Note the "\fR.SH DESCRIPTION" line.  I know almost nothing about the
syntax of these files, but that seems to be the one major difference
between this section header and others.  The others have the .SH
starting at the beginning of the line...

Is this just an upstream bug, or is there a way to work around it
(besides editing the file by hand)?

thanks,
tim


-- System Information:
Debian Release: 5.0
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.26 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages docbook2x depends on:
ii  libc6                      2.7-18        GNU C Library: Shared libraries
ii  libtext-wrapi18n-perl      0.06-6        internationalized substitute of Te
ii  libxml-sax-expat-perl      0.40-1        Perl module for a SAX2 driver for 
ii  opensp                     1.5.2-6       OpenJade group's SGML parsing tool
ii  perl                       5.10.0-19     Larry Wall's Practical Extraction 
ii  texinfo                    4.11.dfsg.1-4 Documentation system for on-line i
ii  xml-core                   0.12          XML infrastructure and XML catalog
ii  xsltproc                   1.1.24-2      XSLT command line processor

Versions of packages docbook2x recommends:
ii  docbook-xml              4.5-6           standard XML documentation system,
ii  docbook-xsl              1.73.2.dfsg.1-5 stylesheets for processing DocBook

docbook2x suggests no packages.

-- no debconf information