Re: NMAP 5.0 man page on Solaris 8 does not display

[David Fifield <david () bamsoftware com>]

On Mon, Jul 20, 2009 at 03:05:15PM -0400, Mike Peterson wrote:
> On Mon, 20 Jul 2009, David Fifield wrote:
> > On Fri, Jul 17, 2009 at 04:31:05PM -0400, Mike Peterson wrote:
> > > The NMAP 5.0 man page does not display on Solaris 8 - it gives:
> > >
> > > Reformatting page.  Please Wait...nroff: Out of temp file space; line 1787, file
> > >  /opt/local/share/man/man1/nmap.1
> > >  done
> > >
> > > Nmap Reference Guide                                      NMAP(1)
> > >
> > > Looks like the page is too much for 'nroff' to handle.
> > > Any ideas?
> >
> > Some web searching indicates that the Solaris nroff can't handle macro
> > names that are longer than two characters. Some of these are inserted by
> > the DocBook stylesheets that generate the man page.
> >
> > http://bugs.opensolaris.org/view_bug.do?bug_id=6510256
> > http://www.mail-archive.com/docbook-apps () lists oasis-open org/msg12270.html
> >
> > I attached a copy of the man page with those macros removed. Does it
> > work for you? We may be able to alter the generation process not to
> > include the macros.
>
> Nice catch - that's got it; I just changed the macro names in the
> existing 'man' pages: 'toupper' to 'tu' and 'SH-xref' to 'Sx', and
> both now display properly.

I notice that this got fixed in version 1.74.1 of the DocBook XSL
stylesheets. They added a parameter man.output.better.ps.enabled,
defaulting to false, that controls whether the special macros are
output.

http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.html#summary_V1.74.1_Params

I have 1.74.3 installed locally and the long macro names are not
included when I generate the man pages. However, the last time they were
generated they were generated with 1.74.0, too early for the fix.
Fyodor, is it convenient to install 1.74.1 or later to make the man
pages compatible with the nroff on Solaris?

David Fifield

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