Re: Problem with man page generation

[David Fifield <david () bamsoftware com>]

On Wed, Mar 06, 2013 at 11:35:36PM +0000, Reuben Thomas wrote:
> In the nroff source for nmap(1), which looks as though it's been
> automatically generated from some other format (so hopefully the fix
> is easy!), comments are often not at the start of a line as they ought
> to be, e.g.:
>
> \(lqinteresting ports table\(rq\&..\" ports: \(lqinteresting\(rq
>
> The result is that a double period ".." appears in the man page,
> rather than a single period at the end of the sentence. The fix is to
> insert a line break before the comment .\".

Thank you for noticing this. I think it happens whenever there is an
indexterm in the source docs/refguide.xml:

    used. Key among that information is the <quote>interesting ports
    table</quote>.<indexterm><primary>ports</primary><secondary 
sortas="interesting">&ldquo;interesting&rdquo;</secondary></indexterm>

I did not know that they were coming through as comments, but I had
noticed the double periods before. Do you perhaps know of a way to
inhibit this behavior when using the DocBook stylesheets?

David Fifield
_______________________________________________
Sent through the dev mailing list
http://nmap.org/mailman/listinfo/dev
Archived at http://seclists.org/nmap-dev/