Subject: bin/9083: makewhatis errors
To: None <gnats-bugs@gnats.netbsd.org>
From: None <mason@primenet.com.au>
List: netbsd-bugs
Date: 12/30/1999 03:57:52
>Number:         9083
>Category:       bin
>Synopsis:       makewhatis produces bad summaries for macros
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people (Utility Bug People)
>State:          open
>Class:          sw-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Dec 30 03:57:00 1999
>Last-Modified:
>Originator:     Geoff C. Wing
>Organization:
Geoff Wing : <gcw@pobox.com>     Work URL: http://www.primenet.com.au/
Rxvt Stuff : <gcw@rxvt.org>      Ego URL : http://pobox.com/~gcw/
Zsh Stuff  : <gcw@zsh.org>       Phone   : (Australia) 0413 431 874
>Release:        ~19991228
>Environment:
System: NetBSD c.primenet.com.au 1.4P NetBSD 1.4P (C) #0: Sat Nov 20 15:18:53 EST 1999 mason@c.primenet.com.au:/usr/netbsd/src/sys/arch/i386/compile/C i386


>Description:
	makewhatis produces some bad output.  I presume that it is fine tuned
	for man pages in the main tree, but with other than those it
	encounters some bad errors with unknown macros.

	Specific example: pkgsrc/graphics/tiff

	whatis.db entry reads:
		tiff2ps (1) - convert a TIFFTIFF image to (Pstm

	tiff2ps.1 has:
		....
		.ds Ps P\s-2OST\s+2S\s-2CRIPT\s+2
		....
		.SH NAME
		tiff2ps \- convert a
		.SM TIFF
		image to \*(Ps\(tm
		.SH SYNOPSIS
		....

	whatis.db entry _should_ read:
		tiff2ps (1) - convert a TIFF image to POSTSCRIPTtm

>How-To-Repeat:
	See above.
	
>Fix:
	Maybe:
	1) Pump every man page (i.e. not cat'd stuff) through nroff and
	   process like a cat page.
	2) Adapt above to only do so on man pages with unknown macros or
	   specials.

	Obviously it will slow it down but does it really matter if it's
	going to produce the right stuff, and let people apropos on, say,
	``postscript'' with correct results.  makewhatis is not time
	sensitive.
>Audit-Trail:
>Unformatted: