Path: utzoo!utgpu!jarvis.csri.toronto.edu!mailrus!csd4.milw.wisc.edu!lll-winken!ames!ncar!husc6!rice!sun-spots-request
From: moran@warbucks.ai.sri.com (Doug Moran)
Newsgroups: comp.sys.sun
Subject: Re: man (-k option)
Keywords: Software
Message-ID: <8903071915.AA05900@muir.ai.sri.com>
Date: 17 Mar 89 02:50:22 GMT
Sender: usenet@rice.edu
Organization: Sun-Spots
Lines: 21
Approved: Sun-Spots@rice.edu
Original-Date: Tue, 7 Mar 89 11:15:54 PST
X-Sun-Spots-Digest: Volume 7, Issue 202, message 9 of 21
X-Issue-Reference: v7n188

The following is a bug report that I sent to hotline@sun.com.  The problem
with "man -k" was already a known bug (bugid: 1011438) and is scheduled to
be fixed in 4.1.

The man command was upgraded to use the MANPATH variable and to have the
value of the -M operand be a set of paths to search for manual entries.

Bug: for the -k operand, "man" looks only at the whatis database in
	the first entry on the list.  I have set my MANPATH variable
	to "/usr/local/man:/usr/man" and when I execute "man -k sign"
	I get only the entries for man pages in /usr/local/man.
	If I type "man -M /usr/man -k sign", I get those in /usr/man
	(proving the whatis database exists).
Workaround: manual cat together the whatis databases from the various
	directories on the path, replacing the whatis database in the
	first directory on that path.

Incompatibility: the -M operand in the catman command is a directory
	and not a list of paths as in the man command.  For compatibility
	this -M operand should be the same as in man, and if omitted it
	should default to the value of MANPATH before defaulting to /usr/man.