diff options
| author | Kristaps Dzonsons <kristaps@bsd.lv> | 2011-11-29 10:53:42 +0000 |
|---|---|---|
| committer | Kristaps Dzonsons <kristaps@bsd.lv> | 2011-11-29 10:53:42 +0000 |
| commit | 34df86dc46608f2598c87e854a8b4fb6369129d9 (patch) | |
| tree | 2134dd9a04b71e7dce49ed05769f493a210fa463 /apropos.1 | |
| parent | ba260b631b89ba11f9cb1397e777e91f3bb3438d (diff) | |
| download | mandoc-34df86dc46608f2598c87e854a8b4fb6369129d9.tar.gz | |
Make `-i' only apply to regular expressions. For the equality operator
(and thus the default), always use strcasestr(). Discussed on tech@
with schwarze@. While here, fix the apropos.c usage() message to be
consistent with apropos(1) and clean up the EXAMPLES in apropos(1).
Diffstat (limited to 'apropos.1')
| -rw-r--r-- | apropos.1 | 38 |
1 files changed, 16 insertions, 22 deletions
@@ -112,11 +112,11 @@ evaluates a substring, while .Li \&~ evaluates a regular expression. .It Fl i Ar term -Same as -.Ar term , -but +If .Ar term +is a regular expression, it is evaluated case-insensitively. +Has no effect on substring terms. .El .Pp By default, @@ -125,7 +125,7 @@ searches for .Xr mandocdb 8 databases in the default paths stipulated by .Xr man 1 , -parses terms as case-insensitive regular expressions +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 . @@ -238,25 +238,25 @@ Invalid paths, or paths without manual databases, are ignored. Overridden by .Fl M . .El -.\" .Sh FILES .Sh EXIT STATUS .Ex -std .Sh EXAMPLES Search for .Qq mdoc -within the manual name and description: +as a substring and regular expression +within each manual name and description: .Pp .Dl $ apropos mdoc +.Dl $ apropos ~^mdoc$ .Pp -Two variants of searching for -.Qq mdoc , -.Qq roff , -or +Include matches for +.Qq roff +and .Qq man -within manual names and descriptions: +for the regular expression case: .Pp -.Dl $ apropos mdoc roff man -.Dl $ apropos mdoc \-o roff \-o man +.Dl $ apropos ~^mdoc$ roff man +.Dl $ apropos ~^mdoc$ \-o roff \-o man .Pp Search for .Qq optind @@ -264,17 +264,11 @@ and .Qq optarg as variable names in the library category: .Pp -.Dl $ apropos \-s 3 \(dqVa~^optind$\(dq -a \(dqVa~^optarg$\(dq -.Pp -Search for all manuals referencing -.Qq POSIX -in any letter case: -.Pp -.Dl $ apropos \-\- \-i posix +.Dl $ apropos \-s 3 Va~^optind \-a Va~^optarg$ .Sh SEE ALSO .Xr man 1 , -.Xr mandoc 1 , -.Xr re_format 7 +.Xr re_format 7 , +.Xr mandocdb 8 .Sh AUTHORS The .Nm |