View Source: apropos(1) - Waikato Linux Users Group

You are viewing an old revision of this page. View the current version.
apropos
!!!apropos
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXIT STATUS
ENVIRONMENT
FILES
SEE ALSO
AUTHOR
----
!!NAME


apropos - search the manual page names and descriptions
!!SYNOPSIS


__apropos__ [[__-dhV__] [[__-e__|__-w__|__-r__]
[[__-m__ ''system''[[,...]] [[__-M__ ''path'']
''keyword'' ...
!!DESCRIPTION


Each manual page has a short description available within
it. __apropos__ searches the descriptions for instances
of ''keyword''.


''keyword'' is usually a regular expression, as if
(__-r__) was used, or may contain wildcards (__-w__)
__,__ or match the exact keyword (__-e__) __.__
Using these options, it may be necessary to quote the
''keyword'' or escape () the special characters to stop
the shell from interpreting them.


The standard matching rules allow matches to be made against
the page name and word boundaries in the
description.
!!OPTIONS


__-d, --debug__


Print debugging information.


__-r, --regex__


Interpret each keyword as a regular expression. This is the
default behaviour. Each keyword will be matched against the
page names and the descriptions independently. It can match
any part of either. The match is not limited to word
boundaries.


__-w, --wildcard__


Interpret each keyword as a pattern containing shell style
wildcards. Each keyword will be matched against the page
names and the descriptions independently. A match will only
be found if an expanded keyword matches an entire
description or page name.


__-e, --exact__


Each keyword will be exactly matched against the page names
and the descriptions.


__-m__ ''system''[[,...]__,
--systems=__''system''[[,...]


If this system has access to other operating system's manual
page descriptions, they can be searched using this option.
To search NewOS's manual page descriptions, use the option
__-m NewOS__.


The ''system'' specified can be a combination of
comma-delimited operating system names. To include a search
of the native operating system's __whatis__ descriptions,
include the system name __man__ in the argument string.
This option will override the $__SYSTEM__ environment
variable.


__-M__ ''path''__,
--manpath=__''path''


Specify an alternate set of colon-delimited manual page
hierarchies to search. By default, __apropos__ uses the
$__MANPATH__ environment variable, unless it is empty or
unset, in which case it will determine an appropriate
manpath based on your $__PATH__ environment variable.
This option overrides the contents of
$__MANPATH__.


__-h, --help__


Print a help message and exit.


__-V, --version__


Display version and author information.
!!EXIT STATUS


__0__


Successful program execution.


__1__


Usage, syntax or configuration file error.


__2__


Operational error.


__16__


Nothing was found that matched the criteria
specified.
!!ENVIRONMENT


__SYSTEM__


If $__SYSTEM__ is set, it will have the same effect as if
it had been specified as the argument to the __-m__
option.


__MANPATH__


If $__MANPATH__ is set, its value is interpreted as the
colon-delimited manual page hierarchy search path to
use.


__POSIXLY_CORRECT__


If $__POSIXLY_CORRECT__ is set, even to a null value, the
default __apropos__ search will be as an extended regex
(__-r__) __.__ Nowadays, this is the default behaviour
anyway.
!!FILES


''/usr/share/man/index.(bt|db|dir|pag)''


A traditional global ''index'' database
cache.


''/var/cache/man/index.(bt|db|dir|pag)''


An alternate or FHS compliant global ''index'' database
cache.


''/usr/share/man/.../whatis''


A traditional __whatis__ text database.
!!SEE ALSO


whatis(1), man(1).
!!AUTHOR


Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
----
132 pages link to apropos(1):
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
Version 1, saved on Tuesday, June 4, 2002 12:21:45 am by "perry"
Edit PageHistory Diff Info LikePages