Subject: bin/3297: no catman/makewhatis, undocumented options for man(1)
To: None <gnats-bugs@gnats.netbsd.org>
From: None <era@iki.fi>
List: netbsd-bugs
Date: 03/06/1997 11:02:00
>Number: 3297
>Category: bin
>Synopsis: no catman/makewhatis, some comments about documentation
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: bin-bug-people (Utility Bug People)
>State: open
>Class: change-request
>Submitter-Id: net
>Arrival-Date: Thu Mar 6 16:50:01 1997
>Last-Modified:
>Originator: System Era
>Organization:
People Who Are Not Old Enough for Unix (Honorary Member Emeritus)
>Release: 1.2
>Environment:
Basically stock 1.2 #1 release, save perhaps for the fact that
I don't use csh
System: NetBSD hello 1.2 NetBSD 1.2 (GENERIC) #1: Wed Sep 11 00:43:55 CDT 1996 scottr@spot:/usr/src/sys/arch/mac68k/compile/GENERIC mac68k
>Description:
1. I could find nothing for updating the whatis.db database,
save for an obscure sed script in /usr/share/man. Is that it?
How about a wrapper a la catman(1) and documentation?
2. No description of the whatis.db format
3. The whatis.db database as shipped contains lots of
references to pages which are not actually included in the
distribution. Good example: almost all the output from
fgrep 'device' /usr/share/man/whatis.db
4. In search of a clue, I stumbled over a few undocumented
switches in man(1):
$ strings /usr/bin/man | grep '^-' | head -1
-aC:cfhkM:m:P:w
$ man -swededagly
man: illegal option -- s
usage: man [-achw] [-C file] [-M path] [-m path] [section] title ...
Ergo: Missing are -f, -k, and -P
5. At one point after I had made my own whatis.db (but before
adding _whatis /usr/local/man/whatis.db to man.conf) I noticed
that man(1) would find my man pages in /usr/local whereas
whatis(1) would not look for whatis.db in the same directory
even if I didn't set up a $MANPATH. They both read man.conf,
couldn't they grok it the same way too?
>How-To-Repeat:
>Fix:
>Audit-Trail:
>Unformatted: