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

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

version 1.15, 2011/12/25 16:53:51 version 1.18, 2012/06/08 10:44:52
Line 1 
Line 1 
 .\"     $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
Line 36  utility queries manual page databases generated by
Line 36  utility queries manual page databases generated by
 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
   and
   parses terms as case-sensitive words
   over manual names and descriptions.
   Multiple terms are OR'd.
   .Pp
 Its arguments are as follows:  Its arguments are as follows:
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Fl C Ar file  .It Fl C Ar file
Line 67  for a listing of manual sections.
Line 79  for a listing of manual sections.
 .Pp  .Pp
 An  An
 .Ar expression  .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 ,  .Li [key[,key]*(=~)]?val ,
 where operand  where operand
 .Cm key  .Cm key
Line 115  See
Line 94  See
 for a list of available keys.  for a list of available keys.
 Operator  Operator
 .Li \&=  .Li \&=
 evaluates a substring, while  evaluates a full string, while
 .Li \&~  .Li \&~
 evaluates a regular expression.  evaluates a
 .It Fl i Ar term  .Xr glob 7
 If  pattern.
 .Ar term  
 is a regular expression, it  
 is evaluated case-insensitively.  
 Has no effect on substring terms.  
 .El  
 .Pp  .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  Results are sorted by manual title, with output formatted as
 .Pp  .Qq title(sec) \- description
 .D1 title(sec) \- description  where
 .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 151  is the manual section, and
Line 111  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
 .Pp  .Qq title(cat/arch) \- description .
 .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
 Queries evaluate over a subset of  Queries evaluate over a subset of
 .Xr mdoc 7  .Xr mdoc 7
Line 276  configuration file
Line 227  configuration file
 .Sh EXAMPLES  .Sh EXAMPLES
 Search for  Search for
 .Qq mdoc  .Qq mdoc
 as a substring and regular expression  as a word or
 within each manual name and description:  .Xr glob 7
   expression:
 .Pp  .Pp
 .Dl $ apropos mdoc  .Dl $ apropos mdoc
 .Dl $ apropos ~^mdoc$  .Dl $ apropos any~mdoc*
 .Pp  .Pp
 Include matches for  Include matches for
 .Qq roff  .Qq roff
 and  and
 .Qq man  .Qq man
 for the regular expression case:  using
   .Xr glob 7
   expressions:
 .Pp  .Pp
 .Dl $ apropos ~^mdoc$ roff man  .Dl $ apropos ~*mdoc* ~*roff*
 .Dl $ apropos ~^mdoc$ \-o roff \-o man  
 .Pp  .Pp
 Search for  Search for
 .Qq optind  
 and  
 .Qq optarg  .Qq optarg
 as variable names in the library category:  as a variable name in the library category:
 .Pp  .Pp
 .Dl $ apropos \-s 3 Va~^optind \-a Va~^optarg$  .Dl $ apropos \-s 3 Va=optarg
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xr man 1 ,  .Xr glob 7 ,
 .Xr re_format 7 ,  
 .Xr mandocdb 8  .Xr mandocdb 8
 .Sh AUTHORS  .Sh AUTHORS
 The  The
Legend:
Removed from v.1.15  
changed lines
  Added in v.1.18
CVSweb