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