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

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

version 1.16.2.3, 2013/10/05 01:25:20 version 1.16.2.4, 2014/03/17 09:52:42
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 71  for
Line 71  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
 An  An
Line 239  Text production:
Line 245  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 277  configuration file
Line 283  configuration file
 .Ex -std  .Ex -std
 .Sh EXAMPLES  .Sh EXAMPLES
 Search for  Search for
 .Qq mdoc  .Qq .cf
 as a substring and regular expression  as a substring of manual names and descriptions:
 within each manual name and description:  
 .Pp  .Pp
 .Dl $ apropos mdoc  .Dl $ apropos .cf
 .Dl $ apropos ~^mdoc$  
 .Pp  .Pp
 Include matches for  Include matches for
 .Qq roff  .Qq .cnf
 and  and
 .Qq man  .Qq .conf
 for the regular expression case:  as well:
 .Pp  .Pp
 .Dl $ apropos ~^mdoc$ roff man  .Dl $ apropos .cf .cnf .conf
 .Dl $ apropos ~^mdoc$ \-o roff \-o man  
 .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  .Qq optind
 and  and the
 .Qq optarg  .Qq optarg
 as variable names in the library category:  variables:
 .Pp  .Pp
 .Dl $ apropos \-s 3 Va~^optind \-a 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 man 1 ,  .Xr man 1 ,
 .Xr re_format 7 ,  .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.16.2.3  
changed lines
  Added in v.1.16.2.4
CVSweb