usr.bin/apropos/apropos.1

   1 .\"     $NetBSD: apropos.1,v 1.11 2009/05/08 12:48:43 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1989, 1990, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. Neither the name of the University nor the names of its contributors
  15 .\"    may be used to endorse or promote products derived from this software
  16 .\"    without specific prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\"     @(#)apropos.1   8.1 (Berkeley) 6/29/93
  31 .\"
  32 .Dd May 7, 2009
  33 .Dt APROPOS 1
  34 .Os
  35 .Sh NAME
  36 .Nm apropos
  37 .Nd locate commands by keyword lookup
  38 .Sh SYNOPSIS
  39 .Nm apropos
  40 .Op Fl C Ar path
  41 .Op Fl M Ar path
  42 .Op Fl m Ar path
  43 .Op Fl S Ar subsection
  44 .Op Fl s Ar section
  45 .Ar keyword ...
  46 .Sh DESCRIPTION
  47 .Nm
  48 shows which manual pages contain instances of any of the given
  49 .Ar keyword(s)
  50 in their title line.
  51 Each word is considered separately and case of letters is ignored.
  52 Words which are part of other words are considered; when looking for
  53 .Dq compile ,
  54 .Nm
  55 will also list all instances of
  56 .Dq compiler .
  57 .Pp
  58 If the line output by
  59 .Nm
  60 starts
  61 .Dq Li name(section) ...
  62 you can enter
  63 .Dq Li man section name
  64 to get
  65 its documentation.
  66 .Pp
  67 The options are as follows:
  68 .Bl -tag -width flag
  69 .It Fl C
  70 Use different
  71 .Xr man 1
  72 configuration file than the default,
  73 .Pa /etc/man.conf .
  74 .It Fl M
  75 Override the list of standard directories
  76 .Nm
  77 searches for a database named
  78 .Pa whatis.db .
  79 The supplied
  80 .Ar path
  81 must be a colon
  82 .Dq \&:
  83 separated list of directories.
  84 This search path may also be set using the environment variable
  85 .Ev MANPATH .
  86 .It Fl m
  87 Augment the list of standard directories
  88 .Nm
  89 searches for its database.
  90 The supplied
  91 .Ar path
  92 must be a colon
  93 .Dq \&:
  94 separated list of directories.
  95 These directories will be searched before the standard directories,
  96 or the directories supplied with the
  97 .Fl M
  98 option or the
  99 .Ev MANPATH
 100 environment variable.
 101 .It Fl S Ar subsection
 102 Restrict the search to pages for the specified machine architecture.
 103 By default, pages for all architectures are shown.
 104 .It Fl s Ar section
 105 Restrict the search to the specified section of the manual.
 106 By default, pages from all sections are shown.
 107 .El
 108 .Sh ENVIRONMENT
 109 .Bl -tag -width MANPATH
 110 .It Ev MANPATH
 111 The standard search path used by
 112 .Xr man 1
 113 may be overridden by specifying a path in the
 114 .Ev MANPATH
 115 environment variable.
 116 The format of the path is a colon
 117 .Dq \&:
 118 separated list of directories.
 119 .El
 120 .Sh FILES
 121 .Bl -tag -width /etc/man.conf1 -compact
 122 .It Pa whatis.db
 123 name of the apropos database
 124 .It Pa /etc/man.conf
 125 .Xr man 1
 126 configuration file, used to get location of whatis database if
 127 .Ev MANPATH
 128 is not set.
 129 .El
 130 .Sh SEE ALSO
 131 .Xr man 1 ,
 132 .Xr whatis 1 ,
 133 .Xr whereis 1 ,
 134 .Xr man.conf 5 ,
 135 .Xr makewhatis 8
 136 .Sh HISTORY
 137 The
 138 .Nm
 139 command appeared in
 140 .Bx 3.0 .