Module Name: othersrc
Committed By: uwe
Date: Tue Oct 5 19:25:28 UTC 2021
Modified Files:
othersrc/external/bsd/agcre/dist: agcre.1
Log Message:
Tweak markup. Sync argument names between text and synopsis.
To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 othersrc/external/bsd/agcre/dist/agcre.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: othersrc/external/bsd/agcre/dist/agcre.1
diff -u othersrc/external/bsd/agcre/dist/agcre.1:1.2 othersrc/external/bsd/agcre/dist/agcre.1:1.3
--- othersrc/external/bsd/agcre/dist/agcre.1:1.2 Thu Aug 17 11:02:04 2017
+++ othersrc/external/bsd/agcre/dist/agcre.1 Tue Oct 5 19:25:28 2021
@@ -1,4 +1,4 @@
-.\" $NetBSD: agcre.1,v 1.2 2017/08/17 11:02:04 wiz Exp $
+.\" $NetBSD: agcre.1,v 1.3 2021/10/05 19:25:28 uwe Exp $
.\"
.\" Copyright (c) 2017 Alistair Crooks <[email protected]>
.\" All rights reserved.
@@ -35,30 +35,36 @@
.Op Fl e Ar expression
.Op Fl f Ar filename
.Op Fl m Ar maxmatch
-.Op Fl P Ar reg_pend
-.Op Fl S Ar subexpression
-.Op Fl T Ar regexp_type
+.Op Fl P Ar end
+.Op Fl S Ar n
+.Op Fl T Ar type
+.Op Ar expression
.Ar file ...
.Sh DESCRIPTION
The
.Nm
-utility uses
+utility uses the
.Xr libagcre 3
-as a regular expression library.
+library to perform textual matches on files and standard input
+in the same way as
+.Xr grep 1 .
+.Pp
The library is built on Rob Pike's Virtual Machine implementation,
-but also recognises back references, Unicode characters and PERL
+but also recognises back references, Unicode characters and Perl
patterns, and performs greedy and non-greedy matching.
-.Bl -tag -width subexpressionXXXXX
+.Bl -tag -width Fl
.It Fl D
Dump the generated virtual machine program to
-.Dv stdout
+.Va stdout
if the
regular expression compilation was successful.
.It Fl e Ar expression
-Use the expression provided in the argument as the expression
+Use the
+.Ar expression
+provided in the argument as the expression
to be compiled.
This is useful if the expression begins with a
-.Dq -
+.Ql \&-
character, for example.
.It Fl f Ar filename
Take the regular expression from the filename provided
@@ -68,55 +74,52 @@ Perform matching in a case-insensitive m
.It Fl l
Suppress output, and merely print the filename for
any expression match.
-.It Fl m Ar N
-Perform matching until N matches are found.
+.It Fl m Ar maxmatch
+Perform matching until
+.Ar maxmatch
+matches are found.
The default is to show all matches.
.It Fl n
Show line numbers in files of any matches found
.It Fl O
Do not print matching text.
Instead, print the offsets of any matching text.
-.It Fl P Ar offset
+.It Fl P Ar end
Use
.Dv AGCRE_REG_PEND
to denote the end offset of the regular expression to be compiled.
.It Fl r
If an argument is found to be a directory, recurse into that directory
and perform matching against all files in that directory.
-.It Fl S Ar N
-Print the subscript matching subexpression number N.
+.It Fl S Ar n
+Print the substring matching subexpression number
+.Ar n .
The default is to print the whole match, subexpression 0.
-.It Fl T Ar nospec|basic|extended
+.It Fl T Ar type
Explicitly specify the type of matching to be performed.
Possible values for this are
-.Dq nospec ,
-.Dq basic ,
+.Ql nospec ,
+.Ql basic ,
and
-.Dq extended .
+.Ql extended .
The default in
.Nm
-is to use extended regular expressions by default.
+is to use extended regular expressions.
There is no default regular expression type in
.Xr libagcre 3 .
.It Fl t
Trace the execution of
.Fn agcre_regexec
by producing tracing information on
-.Dv stderr .
+.Va stderr .
.It Fl V
Print version number and then exit.
.It Fl v
-Perform an inverse match, showing all lines which do not match the
+Perform an inverse match, showing all lines which do
+.Em not
+match the
regular expression.
.El
-.Pp
-The
-.Nm
-utility uses the
-.Xr libagcre 3
-library to perform textual matches on files and standard input
-in the same way as
-.Xr grep 1 .
.Sh SEE ALSO
.Xr grep 1 ,
.Xr libagcre 3 ,
