version 1.10, 2011/11/29 00:41:33 |
version 1.23, 2014/03/17 09:43:56 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" |
.\" |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" purpose with or without fee is hereby granted, provided that the above |
.\" purpose with or without fee is hereby granted, provided that the above |
|
|
.Dt APROPOS 1 |
.Dt APROPOS 1 |
.Os |
.Os |
.Sh NAME |
.Sh NAME |
.Nm apropos |
.Nm apropos , |
|
.Nm whatis |
.Nd search manual page databases |
.Nd search manual page databases |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm |
.Nm |
.Op Fl M Ar manpath |
.Op Fl C Ar file |
.Op Fl m Ar manpath |
.Op Fl M Ar path |
|
.Op Fl m Ar path |
.Op Fl S Ar arch |
.Op Fl S Ar arch |
.Op Fl s Ar section |
.Op Fl s Ar section |
.Ar expression... |
.Ar expression ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm apropos |
utility queries manual page databases generated by |
and |
|
.Nm whatis |
|
utilities query manual page databases generated by |
.Xr mandocdb 8 , |
.Xr mandocdb 8 , |
evaluating on |
evaluating on |
.Ar expression |
.Ar expression |
for each file in each database. |
for each file in each database. |
|
.Pp |
|
By default, |
|
.Nm |
|
searches for |
|
.Xr mandocdb 8 |
|
databases in the default paths stipulated by |
|
.Xr man 1 , |
|
parses terms as case-sensitive regular expressions |
|
.Pq the Li \&~ operator |
|
over manual names and descriptions |
|
.Pq the Li \&Nm No and Li \&Nd No macro keys . |
|
Multiple terms imply pairwise |
|
.Fl o . |
|
.Nm whatis |
|
maps terms only to case-sensitive manual names. |
|
.Pp |
Its arguments are as follows: |
Its arguments are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl M Ar manpath |
.It Fl C Ar file |
|
Specify an alternative configuration |
|
.Ar file |
|
in |
|
.Xr man.conf 5 |
|
format. |
|
.It Fl M Ar path |
Use the colon-separated path instead of the default list of paths |
Use the colon-separated path instead of the default list of paths |
searched for |
searched for |
.Xr mandocdb 8 |
.Xr mandocdb 8 |
databases. |
databases. |
Invalid paths, or paths without manual databases, are ignored. |
Invalid paths, or paths without manual databases, are ignored. |
.It Fl m Ar manpath |
.It Fl m Ar path |
Prepend the colon-separated paths to the list of paths searched |
Prepend the colon-separated paths to the list of paths searched |
for |
for |
.Xr mandocdb 8 |
.Xr mandocdb 8 |
databases. |
databases. |
Invalid paths, or paths without manual databases, are ignored. |
Invalid paths, or paths without manual databases, are ignored. |
.It Fl S Ar arch |
.It Fl S Ar arch |
Search only for a particular architecture. |
Restrict the search to pages for the specified |
.It Fl s Ar cat |
.Xr machine 1 |
Search only for a manual section. |
architecture. |
|
.Ar arch |
|
is case insensitive. |
|
By default, pages for all architectures are shown. |
|
.It Fl s Ar section |
|
Restrict the search to the specified section of the manual. |
|
By default, pages from all sections are shown. |
See |
See |
.Xr man 1 |
.Xr man 1 |
for a listing of manual sections. |
for a listing of sections. |
.El |
.El |
.Pp |
.Pp |
An |
An |
Line 112 evaluates a substring, while |
|
Line 144 evaluates a substring, while |
|
.Li \&~ |
.Li \&~ |
evaluates a regular expression. |
evaluates a regular expression. |
.It Fl i Ar term |
.It Fl i Ar term |
Same as |
If |
.Ar term , |
|
but |
|
.Ar term |
.Ar term |
|
is a regular expression, it |
is evaluated case-insensitively. |
is evaluated case-insensitively. |
|
Has no effect on substring terms. |
.El |
.El |
.Pp |
.Pp |
By default, |
.Nm whatis |
.Nm |
considers an |
searches for |
.Ar expression |
.Xr mandocdb 8 |
to consist of an opaque keyword. |
databases in the default paths stipulated by |
.Pp |
.Xr man 1 , |
|
parses terms as case-insensitive regular expressions |
|
.Pq the Li \&~ operator |
|
over manual names and descriptions |
|
.Pq the Li \&Nm No and Li \&Nd No macro keys . |
|
Multiple terms imply pairwise |
|
.Fl o . |
|
Results are sorted by manual title, with output formatted as |
Results are sorted by manual title, with output formatted as |
.Pp |
.Pp |
.D1 title(sec) \- description |
.D1 title(sec) \- description |
Line 230 Text production: |
|
Line 255 Text production: |
|
.It Li \&Dx Ta Dx No version reference |
.It Li \&Dx Ta Dx No version reference |
.El |
.El |
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Bl -tag -width Ds |
.Bl -tag -width MANPATH |
.It Ev MANPATH |
.It Ev MANPATH |
Colon-separated paths overriding the default list of paths searched for |
The standard search path used by |
manual databases. |
.Xr man 1 |
|
may be changed by specifying a path in the |
|
.Ev MANPATH |
|
environment variable. |
Invalid paths, or paths without manual databases, are ignored. |
Invalid paths, or paths without manual databases, are ignored. |
Overridden by |
Overridden by |
.Fl M . |
.Fl M . |
|
If |
|
.Ev MANPATH |
|
begins with a colon, it is appended to the default list; |
|
if it ends with a colon, it is prepended to the default list; |
|
or if it contains two adjacent colons, |
|
the standard search path is inserted between the colons. |
|
If none of these conditions are met, it overrides the |
|
standard search path. |
.El |
.El |
.\" .Sh FILES |
.Sh FILES |
|
.Bl -tag -width "/etc/man.conf" -compact |
|
.It Pa mandoc.db |
|
name of the |
|
.Xr mandocdb 8 |
|
keyword database |
|
.It Pa /etc/man.conf |
|
default |
|
.Xr man 1 |
|
configuration file |
|
.El |
.Sh EXIT STATUS |
.Sh EXIT STATUS |
.Ex -std |
.Ex -std |
.Sh EXAMPLES |
.Sh EXAMPLES |
Search for |
Search for |
.Qq mdoc |
.Qq .cf |
within the manual name and description: |
as a substring of manual names and descriptions: |
.Pp |
.Pp |
.Dl $ apropos mdoc |
.Dl $ apropos .cf |
.Pp |
.Pp |
Two variants of searching for |
Include matches for |
.Qq mdoc , |
.Qq .cnf |
.Qq roff , |
and |
or |
.Qq .conf |
.Qq man |
as well: |
within manual names and descriptions: |
|
.Pp |
.Pp |
.Dl $ apropos mdoc roff man |
.Dl $ apropos .cf .cnf .conf |
.Dl $ apropos mdoc \-o roff \-o man |
|
.Pp |
.Pp |
Search for |
Search in names and descriptions using a regular expression: |
|
.Pp |
|
.Dl $ apropos '~set.?[ug]id' |
|
.Pp |
|
Search for manuals in the library category mentioning both the |
.Qq optind |
.Qq optind |
and |
and the |
.Qq optarg |
.Qq optarg |
as variable names in the library category: |
variables: |
.Pp |
.Pp |
.Dl $ apropos \-s 3 \(dqVa~^optind$\(dq -a \(dqVa~^optarg$\(dq |
.Dl $ apropos \-s 3 Va=optind \-a Va=optarg |
.Pp |
.Pp |
Search for all manuals referencing |
Do exactly the same as calling |
.Qq POSIX |
.Xr whatis 1 |
in any letter case: |
with the argument |
|
.Qq ssh : |
.Pp |
.Pp |
.Dl $ apropos \-\- \-i posix |
.Dl $ apropos \-\- \-i 'Nm~[[:<:]]ssh[[:>:]]' |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr man 1 , |
.Xr man 1 , |
.Xr mandoc 1 , |
.Xr re_format 7 , |
.Xr re_format 7 |
.Xr mandocdb 8 |
.Sh AUTHORS |
.Sh HISTORY |
|
An |
|
.Nm |
|
utility first appeared in |
|
.Bx 2 . |
|
It was rewritten from scratch for |
|
.Ox 5.1 . |
|
.Pp |
The |
The |
|
.Fl M |
|
option and the |
|
.Ev MANPATH |
|
variable first appeared in |
|
.Bx 4.3 ; |
|
.Fl m |
|
in |
|
.Bx 4.3 Reno ; |
|
.Fl C |
|
in |
|
.Bx 4.4 Lite1 ; |
|
and |
|
.Fl S |
|
and |
|
.Fl s |
|
in |
|
.Ox 4.5 . |
|
.Sh AUTHORS |
|
.An -nosplit |
|
.An Bill Joy |
|
wrote the original |
|
.Bx |
.Nm |
.Nm |
utility was written by |
in February 1979. |
.An Kristaps Dzonsons , |
The current version was written by |
.Mt kristaps@bsd.lv . |
.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv . |