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 <a...@netbsd.org> .\" 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 ,