This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
[docbook-apps] db2man: *roff macro incorrectly rendered, messes up man page
- From: Denis Bradford <denis dot bradford at verizon dot net>
- To: docbook-apps at lists dot oasis-open dot org
- Date: Wed, 23 Mar 2005 19:02:59 -0500
- Subject: [docbook-apps] db2man: *roff macro incorrectly rendered, messes up man page
In the db2man stylesheet, whitespace in the ref page can cause groff
macros to be indented, as in the following output:
==============================================
(1)
NAME
sb-config - a tool used to determine compiler and linker flags
SYNOPSIS
.ad l
sb-config [option]
==============================================
Notice the indented .ad 1 macro line above, which causes it
to display verbatim in the man page.
Below is the source for the above example. If you remove the
leading spaces before <cmdsynopsis>, the .ad 1 line is
left-aligned and the man page renders correctly.
==============================================
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"docbookx.dtd">
<refentry id="sb-config">
<refnamediv>
<refname>sb-config</refname>
<refpurpose>a tool used to determine compiler and linker
flags</refpurpose>
</refnamediv>
<refsection>
<title>SYNOPSIS</title>
<cmdsynopsis>
<command>sb-config</command>
<arg rep="norepeat"><replaceable>option</replaceable></arg>
</cmdsynopsis>
</refsection>
</refentry>
==============================================
I'm running with docbook.xsl 1.68.1 and saxon 6.4.3.