OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] db2man: *roff macro incorrectly rendered, messes up man page

Denis Bradford <denis.bradford@verizon.net> writes:

> In the db2man stylesheet, whitespace in the ref page can cause groff 
> macros to be indented, as in the following output:
> ==============================================
> (1)
>        sb-config - a tool used to determine compiler and linker flags
>            .ad l
>        sb-config [option]
> ==============================================
> Notice the indented .ad 1 macro line above, which causes it
> to display verbatim in the man page.

Bug. Please submit a manpages bug report:


Actually, there may be one there already. Please check before you submit.

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

The are other whitespace bugs like this in the current manpages
stylesheet. The way I personally have worked around them for now
for now is to to some post-processing using perl. For example,
here is a single-line perl command that will fix the problem of
any groff macro that has leading whitespace in front of it:

  perl -p -e 's/^\s+\././g' sb-config.1

Yeah, I know it should be fixed in the stylesheets themselves. I'm
just suggesting the above as a way to work around it for now.


Michael Smith
http://logopoeia.com/  http://www.oreillynet.com/pub/au/890


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]