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
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
