mandoc/apropos.1 - diff

Return to apropos.1 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/apropos.1 between version 1.12 and 1.16.2.3

version 1.12, 2011/11/29 10:59:19

version 1.16.2.3, 2013/10/05 01:25:20

Line 22

.Nd search manual page databases

.Sh SYNOPSIS

.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 section

.Ar expression...

.Ar expression ...

.Sh DESCRIPTION

The

.Nm

Line 35 utility queries manual page databases generated by

Line 36 utility queries manual page databases generated by

evaluating on

.Ar expression

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 .

.Pp

Its arguments are as follows:

.Bl -tag -width Ds

.It Fl M Ar manpath

.It Fl C Ar file

Specify an alternative configuration

.Ar file

.Xr man.conf 5

format.

.It Fl M Ar path

Use the colon-separated path instead of the default list of paths

searched for

.Xr mandocdb 8

databases.

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

for

.Xr mandocdb 8

Line 119 is evaluated case-insensitively.

Line 140 is evaluated case-insensitively.

Has no effect on substring terms.

.El

.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 .

Results are sorted by manual title, with output formatted as

.Pp

.D1 title(sec) \- description

Line 232 Text production:

Line 241 Text production:

.Sh ENVIRONMENT

.Bl -tag -width Ds

.It Ev MANPATH

Colon-separated paths overriding the default list of paths searched for

Colon-separated paths modifying the default list of paths searched for

manual databases.

Invalid paths, or paths without manual databases, are ignored.

Overridden by

.Fl M .

.Ev MANPATH

begins with a

.Sq \&: ,

it is appended to the default list;

else if it ends with

.Sq \&: ,

it is prepended to the default list; else if it contains

.Sq \&:: ,

the default list is inserted between the colons.

If none of these conditions are met, it overrides the default list.

.El

.Sh FILES

.Bl -tag -width "/etc/man.conf" -compact

.It Pa mandoc.db

name of the

.Xr mandocdb 8

keyword database

.It Pa mandoc.index

name of the

.Xr mandocdb 8

filename database

.It Pa /etc/man.conf

default

.Xr man 1

configuration file

.El

.Sh EXIT STATUS

.Ex -std

.Sh EXAMPLES

Line 273 as variable names in the library category:

Line 308 as variable names in the library category:

The

.Nm

utility was written by

.An Kristaps Dzonsons ,

.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv .

.Mt kristaps@bsd.lv .

CVSweb