[BACK]Return to apropos.1 CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/apropos.1 between version 1.22 and 1.23

version 1.22, 2013/10/01 20:56:18 version 1.23, 2014/03/17 09:43:56
Line 45  By default,
Line 45  By default,
 searches for  searches for
 .Xr mandocdb 8  .Xr mandocdb 8
 databases in the default paths stipulated by  databases in the default paths stipulated by
 .Xr man 1  .Xr man 1 ,
 and  parses terms as case-sensitive regular expressions
 maps terms to case-sensitive manual names and descriptions.  .Pq the Li \&~ operator
 Multiple terms are OR'd.  over manual names and descriptions
   .Pq the Li \&Nm No and Li \&Nd No macro keys .
   Multiple terms imply pairwise
   .Fl o .
 .Nm whatis  .Nm whatis
 maps terms only to case-sensitive manual names.  maps terms only to case-sensitive manual names.
 .Pp  .Pp
Line 73  for
Line 76  for
 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
 .Nm whatis  An
 considers an  
 .Ar expression  .Ar expression
 to consist of an opaque keyword.  consists of search terms joined by logical operators
 .Nm apropos  .Fl a
 parses a  .Pq and
 .Ar expression  and
 into type and keyword pairs.  .Fl o
 This pair syntax  .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 ,  .Li [key[,key]*(=~)]?val ,
 where operand  where operand
 .Cm key  .Cm key
Line 103  See
Line 140  See
 for a list of available keys.  for a list of available keys.
 Operator  Operator
 .Li \&=  .Li \&=
 evaluates a full string, while  evaluates a substring, while
 .Li \&~  .Li \&~
 evaluates a  evaluates a regular expression.
 .Xr glob 7  .It Fl i Ar term
 pattern.  If
   .Ar term
   is a regular expression, it
   is evaluated case-insensitively.
   Has no effect on substring terms.
   .El
 .Pp  .Pp
   .Nm whatis
   considers an
   .Ar expression
   to consist of an opaque keyword.
   .Pp
 Results are sorted by manual title, with output formatted as  Results are sorted by manual title, with output formatted as
 .Qq title(sec) \- description  .Pp
 where  .D1 title(sec) \- description
   .Pp
   Where
 .Qq title  .Qq title
 is the manual's title (note multiple manual names may exist for one  is the manual's title (note multiple manual names may exist for one
 title),  title),
Line 120  is the manual section, and
Line 169  is the manual section, and
 .Qq description  .Qq description
 is the manual's short description.  is the manual's short description.
 If an architecture is specified for the manual, it is displayed as  If an architecture is specified for the manual, it is displayed as
 .Qq title(cat/arch) \- description .  .Pp
   .D1 title(cat/arch) \- description
   .Pp
   Resulting manuals may be accessed as
   .Pp
   .Dl $ man \-s sec title
   .Pp
   If an architecture is specified in the output, use
   .Pp
   .Dl $ man \-s sec \-S arch title
 .Ss Macro Keys  .Ss Macro Keys
 .Nm apropos  Queries evaluate over a subset of
 queries evaluate over a subset of  
 .Xr mdoc 7  .Xr mdoc 7
 macros indexed by  macros indexed by
 .Xr mandocdb 8 .  .Xr mandocdb 8 .
Line 198  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 modifying 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  If
 .Ev MANPATH  .Ev MANPATH
 begins with a  begins with a colon, it is appended to the default list;
 .Sq \&: ,  if it ends with a colon, it is prepended to the default list;
 it is appended to the default list;  or if it contains two adjacent colons,
 else if it ends with  the standard search path is inserted between the colons.
 .Sq \&: ,  If none of these conditions are met, it overrides the
 it is prepended to the default list; else if it contains  standard search path.
 .Sq \&:: ,  
 the default list is inserted between the colons.  
 If none of these conditions are met, it overrides the default list.  
 .El  .El
 .Sh FILES  .Sh FILES
 .Bl -tag -width "/etc/man.conf" -compact  .Bl -tag -width "/etc/man.conf" -compact
Line 232  configuration file
Line 289  configuration file
 .Ex -std  .Ex -std
 .Sh EXAMPLES  .Sh EXAMPLES
 Search for  Search for
 .Qq mdoc  .Qq .cf
 as a word or  as a substring of manual names and descriptions:
 .Xr glob 7  
 expression:  
 .Pp  .Pp
 .Dl $ apropos mdoc  .Dl $ apropos .cf
 .Dl $ apropos any~mdoc*  
 .Pp  .Pp
 Include matches for  Include matches for
 .Qq roff  .Qq .cnf
 and  and
 .Qq man  .Qq .conf
 using  as well:
 .Xr glob 7  
 expressions:  
 .Pp  .Pp
 .Dl $ apropos ~*mdoc* ~*roff*  .Dl $ apropos .cf .cnf .conf
 .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
   and the
 .Qq optarg  .Qq optarg
 as a variable name in the library category:  variables:
 .Pp  .Pp
 .Dl $ apropos \-s 3 Va=optarg  .Dl $ apropos \-s 3 Va=optind \-a Va=optarg
   .Pp
   Do exactly the same as calling
   .Xr whatis 1
   with the argument
   .Qq ssh :
   .Pp
   .Dl $ apropos \-\- \-i 'Nm~[[:<:]]ssh[[:>:]]'
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xr glob 7 ,  .Xr man 1 ,
   .Xr re_format 7 ,
 .Xr mandocdb 8  .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.
   The current version was written by
 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv .  .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv .
Legend:
Removed from v.1.22  
changed lines
  Added in v.1.23
CVSweb