Return-Path: owner-linux-doc@vger.rutgers.edu
Received: from kantti.helsinki.fi (root@kantti.Helsinki.FI [128.214.4.16]) by keos.cs.Helsinki.FI (8.6.10/H46) with ESMTP id BAA14438 for <wirzeniu@cs.Helsinki.FI>; Sun, 30 Jul 1995 01:03:39 +0300
Received: from vger.rutgers.edu (majordomo@vger.rutgers.edu [128.6.190.2]) by kantti.helsinki.fi (8.6.12+Emil1.1/8.6.5) with SMTP id BAA13615 for <wirzeniu@cc.helsinki.fi>; Sun, 30 Jul 1995 01:03:36 +0300
Received: (from majordomo@localhost) by vger.rutgers.edu (8.6.12/8.6.12) id QAA19730 for linux-doc-outgoing; Sat, 29 Jul 1995 16:15:55 -0400
Date: Sat, 29 Jul 1995 22:10:15 +0200
From: Andries.Brouwer@cwi.nl
Message-Id: <9507292010.AA25340=aeb@zeus.cwi.nl>
To: kaos@melbpc.org.au, linux-doc@vger.rutgers.edu
Subject: Re: linux-doc: Missing man page references
Sender: owner-linux-doc@vger.rutgers.edu
Precedence: bulk
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Content-Length: 1508
Status: RO
X-Status: A


	The idea of (optionally) building a complete database of manual pages
	is attractive if it can be done in reasonable time, i.e. if it is
	practical.  One possibility is to use mkid

Yes.

When I added the -K option to man, I also played for a while with
similar possibilities. (For example, "gindxbib -w" is also a
possibility; it indexes all man pages within a few seconds.)

My main problem is that I have difficulty in viewing precisely
how the user is going to use this possibility.

For example, if you want to find something about open, then
        % man -K open
will find you more than a hundred pages (I believe there were 144
under /usr/man and lots of others elsewhere.). It will ask interactively:
        % man -K 2 open
        /usr/man/man2/access.2? [ynq] n
        /usr/man/man2/accept.2? [ynq] n
        /usr/man/man2/termios.2? [ynq] n
        /usr/man/man2/open.2? [ynq]
and show the pages for which you answer yes.

There are really only few words that will be successful, in the
sense that one obtains a relatively short list of mostly relevant pages.
        % man -K ioctl
yields slightly over 20 pages.

So, maybe this is not a very useful option.
And if it is not used, then there is no point in first making an
index, that has to be updated each time new pages are added,
in order to save a minute that seldom time that someone
really wants to know about all man pages mentioning ulimit.

I hope someone will contradict me and tell that "man -K" really
is very useful.

Andries

