This is the mail archive of the docbook-apps@lists.oasis-open.org mailing list .


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[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.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]