Nmap Development mailing list archives

Re: Bug#459884: nmap: Error in man page


From: Fyodor <fyodor () insecure org>
Date: Sat, 12 Jan 2008 20:31:42 -0800

On Thu, Jan 10, 2008 at 02:33:45PM -0800, Fyodor wrote:
On Wed, Jan 09, 2008 at 11:41:14AM +0100, Richard van den Berg wrote:
This is because in /usr/share/man/man1/nmap.1.gz twice a line starts with
"\.nse" which is confused for the .ns nroff "no-space mode" command.

A fix suggested at http://seclists.org/nmap-dev/2007/q4/0305.html is to put
the "\.nse" on the previous line.

I'm afraid it isn't that easy.  nmap.1 is generated from DocBook
source (docs/nmap.xml in the Nmap tarball) using xsltproc.  The best
solution would be to fix whatever part of the toolchain is producing
the invalid nroff.

I'm afraid nobody came up with ideas for fixing this the right way
(which would likely involve fixing the DocBook XSL to nroff man page
stylesheets).  So I just wimped out and did the easy
workaround--reworded the man page to talk about files with the "nse
extension" rather than using the string ".nse" which caused problems.
So the next Nmap release should resolve that, and the regenerated man
page is already available at http://insecure.org/nmap/data/nmap.1 or
in SVN if someone wants to test it further.  My version of man didn't
complain about the previous version.

Cheers,
-F


_______________________________________________
Sent through the nmap-dev mailing list
http://cgi.insecure.org/mailman/listinfo/nmap-dev
Archived at http://SecLists.Org


Current thread: