cleanups, add manual page

[unix-history] / usr / src / usr.bin / apropos / apropos.1

diff --git a/usr/src/usr.bin/apropos/apropos.1 b/usr/src/usr.bin/apropos/apropos.1
index aef4916..a57eea3 100644 (file)
--- a/usr/src/usr.bin/apropos/apropos.1
+++ b/usr/src/usr.bin/apropos/apropos.1
@@ -1,43 +1,38 @@
-.\"    @(#)apropos.1   4.1 (Berkeley) %G%
+.\" Copyright (c) 1980 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.

 .\"
 .\"

-.TH APROPOS 1 2/24/79
+.\"    @(#)apropos.1   6.5 (Berkeley) %G%
+.\"
+.TH APROPOS 1 ""

 .AT 3
 .SH NAME
 apropos \- locate commands by keyword lookup
 .SH SYNOPSIS
 .B apropos
 .AT 3
 .SH NAME
 apropos \- locate commands by keyword lookup
 .SH SYNOPSIS
 .B apropos

+[
+.B -M
+.I path
+]

 keyword ...
 .SH DESCRIPTION
 keyword ...
 .SH DESCRIPTION

-.I Apropos
-shows which manual sections contain instances of any of the given
-keywords in their title.
-Each word is considered separately and case of letters is ignored.
-Words which are part of other words are considered thus looking for
-compile will hit all instances of `compiler' also.
-Try
-.IP
-apropos password
-.PP
-and
-.IP
-apropos editor
+\fIApropos\fP shows which manual pages contain instances of any of the given
+\fIkeyword\fP(s) in their title line.  Each word is considered separately
+and case of letters is ignored.  Words which are part of other words are
+considered; when looking for compile, \fIapropos\fP will also find all
+instances of ``compiler''.

 .PP
 .PP

-If the line starts `name(section) ...' you can do
-`man section name' to get the documentation for it.
-Try `apropos format' and then `man 3s printf' to get the manual
-on the subroutine
-.I printf.
+If the line output by \fIapropos\fP starts ``name(section) ...'' you can
+enter ``man section name'' to get its documentation.

 .PP
 .PP

-.I Apropos
-is actually just the
-.B \-k
-option to the
-.IR man (2)
-command.
+Normally \fIapropos\fP checks in a standard location (/usr/man) for its
+database ``whatis''.  This can be changed by supplying a \fIpath\fP (a
+la the Bourne shell) with the \fB-M\fP flag.  This search path must be
+a colon (``:'') separated list of directories which \fIapropos\fP will
+search for files named ``whatis''.  The path can also be set with the
+environmental variable \fIMANPATH\fP.

 .SH FILES
 .DT
 .SH FILES
 .DT

-/usr/lib/whatis                data base
+/usr/man/whatis                data base

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-man(1), whatis(1), catman(8)
-.SH AUTHOR
-William Joy
+man(1), whatis(1)