Bug#459884: nmap: Error in man page
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 -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
Bug#459884: nmap: Error in man page
Fyodor wrote: 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. If you have suggestions or ideas, I'd be happy to hear them. We use DocBook as the official man page source because we also generate HTML and PDF versions. I understand there is a flaw in the generation process that is beyond your control, but the fact remains that the debian package ships with a faulty man page. The fix (at least for debian) might be easy by patching nmap.1 after it has been generated. I filed this bug from a usability perspective (viewing the man page generates errors and misses 2 lines), not to point out anyone made a mistake somewhere. Richard -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
Bug#459884: nmap: Error in man page
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. If you have suggestions or ideas, I'd be happy to hear them. We use DocBook as the official man page source because we also generate HTML and PDF versions. Cheers, -F -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
Bug#459884: nmap: Error in man page
Package: nmap Version: 4.50-4 Severity: normal When running "man nmap", I get: /tmp/zmanLs6Vo2:999: a special character is not allowed in a name /tmp/zmanLs6Vo2:999: warning: `nse' not defined (probable missing space after `ns') /tmp/zmanLs6Vo2:1025: warning: `nse)' not defined (probable missing space after `ns') 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. -- System Information: Debian Release: 4.0 APT prefers stable APT policy: (990, 'stable'), (400, 'testing'), (300, 'experimental'), (300, 'unstable') Architecture: amd64 (x86_64) Shell: /bin/sh linked to /bin/bash Kernel: Linux 2.6.22-rvdb Locale: LANG=en_US.ISO-8859-15, LC_CTYPE=en_US.ISO-8859-15 (charmap=ISO-8859-15) Versions of packages nmap depends on: ii libc6 2.7-5 GNU C Library: Shared libraries ii libgcc1 1:4.2.2-4 GCC support library ii libpcap0.80.9.5-1System interface for user-level pa ii libpcre3 6.7+7.4-2 Perl 5 Compatible Regular Expressi ii libssl0.9.8 0.9.8g-3 SSL shared libraries ii libstdc++64.2.2-4The GNU Standard C++ Library v3 nmap recommends no packages. -- no debconf information -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]