1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\"
  12 .\" Copyright 2012 Nexenta Systems, Inc. All rights reserved.
  13 .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
  14 .\"
  15 .Dd Jul 13, 2014
  16 .Dt APROPOS 1
  17 .Os
  18 .Sh NAME
  19 .Nm apropos ,
  20 .Nm whatis
  21 .Nd keyword search in
  22 .Nm whatis
  23 database files
  24 .Sh SYNOPSIS
  25 .Nm
  26 .Op Fl M Ar path
  27 .Op Fl s Ar section
  28 .Ar keyword ...
  29 .Nm whatis
  30 .Op Fl M Ar path
  31 .Op Fl s Ar section
  32 .Ar keyword ...
  33 .Sh DESCRIPTION
  34 The
  35 .Nm
  36 utility searches a set of
  37 .Nm whatis
  38 database files matching each
  39 .Ar keyword .
  40 The
  41 .Nm whatis
  42 utility does the same search but only on complete words. The
  43 .Nm whatis
  44 database files are created using
  45 .Xr man 1
  46 command.
  47 .Bl -tag -width ".Fl d"
  48 .It Fl M Ar path
  49 Force a specific colon separated manual path instead of the default search path.
  50 Overrides the
  51 .Ev MANPATH
  52 environment variable.
  53 .It Fl s Ar section
  54 Restrict search to specified
  55 .Ar section .
  56 .El
  57 .Sh ENVIRONMENT
  58 The following environment variables affect the execution of
  59 .Nm :
  60 .Bl -tag -width ".Ev MANPATH , PATH"
  61 .It Ev MANPATH , PATH
  62 Used to find the location of the
  63 .Nm whatis
  64 database files.
  65 .El
  66 .Sh DIAGNOSTICS
  67 The
  68 .Nm
  69 utility exits 0 if a keyword matched and 1 if no keywords are matched or no
  70 .Nm whatis
  71 databases are found.
  72 .Sh INTERFACE STABILITY
  73 Committed.
  74 .Sh CODE SET INDEPENDENCE
  75 Enabled.
  76 .Sh SEE ALSO
  77 .Xr man 1 ,
  78 .Xr mandoc 1