mandoc/apropos.1 - diff

Return to apropos.1 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/apropos.1 between version 1.17 and 1.18

version 1.17, 2012/03/24 01:46:25

version 1.18, 2012/06/08 10:44:52

Line 42 By default,

searches for

.Xr mandocdb 8

databases in the default paths stipulated by

.Xr man 1 ,

.Xr man 1

parses terms as case-sensitive regular expressions

and

parses terms as case-sensitive words

over manual names and descriptions.

Multiple terms imply pairwise

Multiple terms are OR'd.

.Fl o .

If standard output is a TTY, a result may be selected from a list and

its manual displayed with the pager.

.Pp

Its arguments are as follows:

.Bl -tag -width Ds

Line 81 for a listing of manual sections.

Line 79 for a listing of manual sections.

.Pp

.Ar expression

consists of search terms joined by logical operators

consists of type and keyword pairs.

.Fl a

This pair syntax

.Pq and

and

.Fl o

.Pq or .

The

.Fl a

operator has precedence over

.Fl o

and both are evaluated left-to-right.

.Bl -tag -width Ds

.It \&( Ar expr No \&)

True if the subexpression

.Ar expr

is true.

.It Ar expr1 Fl a Ar expr2

True if both

.Ar expr1

and

.Ar expr2

are true (logical

.Qq and ) .

.It Ar expr1 Oo Fl o Oc Ar expr2

True if

.Ar expr1

and/or

.Ar expr2

evaluate to true (logical

.Qq or ) .

.It Ar term

True if

.Ar term

is satisfied.

This has syntax

.Li [key[,key]*(=~)]?val ,

where operand

.Cm key

Line 129 See

Line 94 See

for a list of available keys.

Operator

.Li \&=

evaluates a substring, while

evaluates a full string, while

.Li \&~

evaluates a regular expression.

evaluates a

.It Fl i Ar term

.Xr glob 7

pattern.

.Ar term

is a regular expression, it

is evaluated case-insensitively.

Has no effect on substring terms.

.El

.Pp

Results are sorted by manual title, with output formatted as

.Pp

.Qq title(sec) \- description

.D1 title(sec) \- description

where

.Pp

Where

.Qq title

is the manual's title (note multiple manual names may exist for one

title),

Line 153 is the manual section, and

Line 111 is the manual section, and

.Qq description

is the manual's short description.

If an architecture is specified for the manual, it is displayed as

.Pp

.Qq title(cat/arch) \- description .

.D1 title(cat/arch) \- description

.Pp

If on a TTY, results are prefixed with a numeric identifier.

.Pp

.D1 [index] title(cat) \- description

.Pp

One may choose a manual be entering the index at the prompt.

Valid choices are displayed using

.Ev MANPAGER ,

or failing that ,

.Ev PAGER

or just

.Xr more 1 .

Source pages are formatted with

.Xr mandoc 1 ;

preformatted pages with

.Xr cat 1 .

.Ss Macro Keys

Queries evaluate over a subset of

.Xr mdoc 7

Line 248 Text production:

Line 189 Text production:

.El

.Sh ENVIRONMENT

.Bl -tag -width Ds

.It Ev MANPAGER

Default pager for manuals.

If this is unset, falls back to

.Ev Pager .

.It Ev PAGER

The second choice for a manual pager.

If this is unset, use

.Xr more 1 .

.It Ev MANPATH

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

manual databases.

Line 294 configuration file

Line 227 configuration file

.Sh EXAMPLES

Search for

.Qq mdoc

as a substring and regular expression

as a word or

within each manual name and description:

.Xr glob 7

expression:

.Pp

.Dl $ apropos mdoc

.Dl $ apropos ~^mdoc$

.Dl $ apropos any~mdoc*

.Pp

Include matches for

.Qq roff

and

.Qq man

for the regular expression case:

using

.Xr glob 7

expressions:

.Pp

.Dl $ apropos ~^mdoc$ roff man

.Dl $ apropos ~*mdoc* ~*roff*

.Dl $ apropos ~^mdoc$ \-o roff \-o man

.Pp

Search for

.Qq optind

and

.Qq optarg

as variable names in the library category:

as a variable name in the library category:

.Pp

.Dl $ apropos \-s 3 Va~^optind \-a Va~^optarg$

.Dl $ apropos \-s 3 Va=optarg

.Sh SEE ALSO

.Xr more 1

.Xr glob 7 ,

.Xr re_format 7 ,

.Xr mandocdb 8

.Sh AUTHORS

The

CVSweb