bsdgrep(1): Sneak in some man page updates

- The --exclude{,-dir} and --include{,-dir} directives now match GNU
  behavior of being processed in order and latest matching directive wins

- --label was previously not really documented, and -L and -l did not
  indicate that --label applied to them

- The flags listed as being extensions to POSIX spec were not updated with
  the removal of compression-related flags

MFC after:	1 week
This commit is contained in:
Kyle Evans 2018-04-25 16:28:51 +00:00
parent a18528077c
commit bd509bdb85
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=333001

View File

@ -175,9 +175,11 @@ If specified, it excludes files matching the given
filename pattern from the search. filename pattern from the search.
Note that Note that
.Fl Fl exclude .Fl Fl exclude
patterns take priority over and
.Fl Fl include .Fl Fl include
patterns, and if no patterns are processed in the order given.
If a name patches multiple patterns, the latest matching rule wins.
If no
.Fl Fl include .Fl Fl include
pattern is specified, all files are searched that are pattern is specified, all files are searched that are
not excluded. not excluded.
@ -190,9 +192,11 @@ is specified, it excludes directories matching the
given filename pattern from the search. given filename pattern from the search.
Note that Note that
.Fl Fl exclude-dir .Fl Fl exclude-dir
patterns take priority over and
.Fl Fl include-dir .Fl Fl include-dir
patterns, and if no patterns are processed in the order given.
If a name patches multiple patterns, the latest matching rule wins.
If no
.Fl Fl include-dir .Fl Fl include-dir
pattern is specified, all directories are searched that are pattern is specified, all directories are searched that are
not excluded. not excluded.
@ -242,10 +246,11 @@ is case sensitive.
If specified, only files matching the If specified, only files matching the
given filename pattern are searched. given filename pattern are searched.
Note that Note that
.Fl Fl exclude
patterns take priority over
.Fl Fl include .Fl Fl include
patterns. and
.Fl Fl exclude
patterns are processed in the order given.
If a name patches multiple patterns, the latest matching rule wins.
Patterns are matched to the full path specified, Patterns are matched to the full path specified,
not only to the filename component. not only to the filename component.
.It Fl Fl include-dir .It Fl Fl include-dir
@ -254,17 +259,20 @@ If
is specified, only directories matching the is specified, only directories matching the
given filename pattern are searched. given filename pattern are searched.
Note that Note that
.Fl Fl exclude-dir
patterns take priority over
.Fl Fl include-dir .Fl Fl include-dir
patterns. and
.Fl Fl exclude-dir
patterns are processed in the order given.
If a name patches multiple patterns, the latest matching rule wins.
.It Fl L , Fl Fl files-without-match .It Fl L , Fl Fl files-without-match
Only the names of files not containing selected lines are written to Only the names of files not containing selected lines are written to
standard output. standard output.
Pathnames are listed once per file searched. Pathnames are listed once per file searched.
If the standard input is searched, the string If the standard input is searched, the string
.Dq (standard input) .Dq (standard input)
is written. is written unless a
.Fl Fl label
is specified.
.It Fl l , Fl Fl files-with-matches .It Fl l , Fl Fl files-with-matches
Only the names of files containing selected lines are written to Only the names of files containing selected lines are written to
standard output. standard output.
@ -274,7 +282,18 @@ making searches potentially less expensive.
Pathnames are listed once per file searched. Pathnames are listed once per file searched.
If the standard input is searched, the string If the standard input is searched, the string
.Dq (standard input) .Dq (standard input)
is written. is written unless a
.Fl Fl label
is specified.
.It Fl Fl label
Label to use in place of
.Dq (standard input)
for a file name where a file name would normally be printed.
This option applies to
.Fl H ,
.Fl L ,
and
.Fl l .
.It Fl Fl mmap .It Fl Fl mmap
Use Use
.Xr mmap 2 .Xr mmap 2
@ -450,7 +469,7 @@ utility is compliant with the
specification. specification.
.Pp .Pp
The flags The flags
.Op Fl AaBbCDdGHhIJLmoPRSUVwZ .Op Fl AaBbCDdGHhILmoPRSUVw
are extensions to that specification, and the behaviour of the are extensions to that specification, and the behaviour of the
.Fl f .Fl f
flag when used with an empty pattern file is left undefined. flag when used with an empty pattern file is left undefined.