mandoc/apropos.1 - diff

Return to apropos.1 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/apropos.1 between version 1.5 and 1.10

version 1.5, 2011/11/20 15:43:14

version 1.10, 2011/11/29 00:41:33

Line 22

.Nd search manual page databases

.Sh SYNOPSIS

.Nm

.Op Fl M Ar manpath

.Op Fl m Ar manpath

.Op Fl S Ar arch

.Op Fl s Ar section

Line 30

Line 31

The

.Nm

utility queries manual page databases generated by

.Xr mandocdb 8 ,

evaluating on

.Ar expression

for each file in each database.

Its arguments are as follows:

.Bl -tag -width Ds

.It Fl M Ar manpath

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

A colon-separated list of paths containing

Prepend the colon-separated paths to the list of paths searched

for

.Xr mandocdb 8

databases.

Paths may be relative or absolute.

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

.It Fl S Ar arch

Search only for a particular architecture.

.It Fl s Ar cat

Line 63 The

Line 71 The

operator has precedence over

.Fl o

and both are evaluated left-to-right.

.Pp

.Bl -tag -width Ds

.It \&( Ar expr No \&)

True if the subexpression

Line 90 is satisfied.

Line 97 is satisfied.

This has syntax

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

where operand

.Li key

.Cm key

is an

.Xr mdoc 7

macro to query and

.Li val

.Cm val

is its value.

See

.Sx Macro Keys

for a list of available keys.

Operator

.Li \&=

evaluates a substring, while

Line 113 By default,

Line 123 By default,

.Nm

searches for

.Xr mandocdb 8

database in the current working directory and

databases in the default paths stipulated by

parses terms as case-sensitive regular expressions

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

.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

Line 143 Resulting manuals may be accessed as

Line 154 Resulting manuals may be accessed as

If an architecture is specified in the output, use

.Pp

.Dl $ man \-s sec \-S arch title

.\" .Sh IMPLEMENTATION NOTES

.Ss Macro Keys

.\" Not used in OpenBSD.

Queries evaluate over a subset of

.\" .Sh RETURN VALUES

.Xr mdoc 7

.\" For sections 2, 3, & 9 only.

macros indexed by

.\" .Sh ENVIRONMENT

.Xr mandocdb 8 .

.\" For sections 1, 6, 7, & 8 only.

In addition to the macro keys listed below, the special key

.Cm any

may be used to match any available macro key.

.Pp

Names and description:

.Bl -column "xLix" description -offset indent -compact

.It Li \&Nm Ta manual name

.It Li \&Nd Ta one-line manual description

.El

.Pp

Sections and cross references:

.Bl -column "xLix" description -offset indent -compact

.It Li \&Sh Ta section header (excluding standard sections)

.It Li \&Ss Ta subsection header

.It Li \&Xr Ta cross reference to another manual page

.It Li \&Rs Ta bibliographic reference

.El

.Pp

Semantic markup for command line utilities:

.Bl -column "xLix" description -offset indent -compact

.It Li \&Fl Ta command line options (flags)

.It Li \&Cm Ta command modifier

.It Li \&Ar Ta command argument

.It Li \&Ic Ta internal or interactive command

.It Li \&Ev Ta environmental variable

.It Li \&Pa Ta file system path

.El

.Pp

Semantic markup for function libraries:

.Bl -column "xLix" description -offset indent -compact

.It Li \&Lb Ta function library name

.It Li \&In Ta include file

.It Li \&Ft Ta function return type

.It Li \&Fn Ta function name

.It Li \&Fa Ta function argument type and name

.It Li \&Vt Ta variable type

.It Li \&Va Ta variable name

.It Li \&Dv Ta defined variable or preprocessor constant

.It Li \&Er Ta error constant

.It Li \&Ev Ta environmental variable

.El

.Pp

Various semantic markup:

.Bl -column "xLix" description -offset indent -compact

.It Li \&An Ta author name

.It Li \&Lk Ta hyperlink

.It Li \&Mt Ta Do mailto Dc hyperlink

.It Li \&Cd Ta kernel configuration declaration

.It Li \&Ms Ta mathematical symbol

.It Li \&Tn Ta tradename

.El

.Pp

Physical markup:

.Bl -column "xLix" description -offset indent -compact

.It Li \&Em Ta italic font or underline

.It Li \&Sy Ta boldface font

.It Li \&Li Ta typewriter font

.El

.Pp

Text production:

.Bl -column "xLix" description -offset indent -compact

.It Li \&St Ta reference to a standards document

.It Li \&At Ta At No version reference

.It Li \&Bx Ta Bx No version reference

.It Li \&Bsx Ta Bsx No version reference

.It Li \&Nx Ta Nx No version reference

.It Li \&Fx Ta Fx No version reference

.It Li \&Ox Ta Ox No version reference

.It Li \&Dx Ta Dx No version reference

.El

.Sh ENVIRONMENT

.Bl -tag -width Ds

.It Ev MANPATH

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

manual databases.

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

Overridden by

.Fl M .

.El

.\" .Sh FILES

.Sh EXIT STATUS

.Ex -std

Line 182 Search for all manuals referencing

Line 271 Search for all manuals referencing

in any letter case:

.Pp

.Dl $ apropos \-\- \-i posix

.\" .Sh DIAGNOSTICS

.\" For sections 1, 4, 6, 7, & 8 only.

.\" .Sh ERRORS

.\" For sections 2, 3, & 9 only.

.Sh SEE ALSO

.Xr man 1 ,

.Xr mandoc 1 ,

.Xr re_format 7

.\" .Sh STANDARDS

.\" .Sh HISTORY

.Sh AUTHORS

The

.Nm

utility was written by

.An Kristaps Dzonsons ,

.Mt kristaps@bsd.lv .

.\" .Sh CAVEATS

.\" .Sh BUGS

.\" .Sh SECURITY CONSIDERATIONS

.\" Not used in OpenBSD.

CVSweb