Module Name: othersrc
Committed By: wiz
Date: Thu Aug 17 11:02:04 UTC 2017
Modified Files:
othersrc/external/bsd/agcre/dist: agcre.1
Log Message:
Sort options. Remove empty EXAMPLES section.
To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 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.1 othersrc/external/bsd/agcre/dist/agcre.1:1.2
--- othersrc/external/bsd/agcre/dist/agcre.1:1.1 Wed Aug 16 23:38:13 2017
+++ othersrc/external/bsd/agcre/dist/agcre.1 Thu Aug 17 11:02:04 2017
@@ -1,4 +1,4 @@
-.\" $NetBSD: agcre.1,v 1.1 2017/08/16 23:38:13 agc Exp $
+.\" $NetBSD: agcre.1,v 1.2 2017/08/17 11:02:04 wiz Exp $
.\"
.\" Copyright (c) 2017 Alistair Crooks <a...@netbsd.org>
.\" All rights reserved.
@@ -31,13 +31,13 @@
.Nd efficient grep-like program
.Sh SYNOPSIS
.Nm
-.Op Fl DOVilnrtv
-.Op Fl P Ar reg_pend
-.Op Fl S Ar subexpression
-.Op Fl T Ar regexp_type
+.Op Fl DilnOrtVv
.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
.Ar file ...
.Sh DESCRIPTION
The
@@ -48,35 +48,12 @@ as a regular expression library.
The library is built on Rob Pike's Virtual Machine implementation,
but also recognises back references, Unicode characters and PERL
patterns, and performs greedy and non-greedy matching.
-.Pp
.Bl -tag -width subexpressionXXXXX
.It Fl D
Dump the generated virtual machine program to
.Dv stdout
if the
-regular expression compilation was successful
-.It Fl O
-Do not print matching text. Instead, print the offsets of any matching text.
-.It Fl P Ar offset
-Use
-.Dv AGCRE_REG_PEND
-to denote the end offset of the regular expression to be compiled
-.It Fl S Ar N
-print the subscript matching subexpression number N.
-The default is to print the whole match, subexpression 0.
-.It Fl T Ar nospec|basic|extended
-Explicitly specify the type of matching to be performed.
-Possible values for this are
-.Dq nospec ,
-.Dq basic and
-.Dq extended .
-The default in
-.Nm
-is to use extended regular expressions by default.
-There is no default regular expression type in
-.Xr libagcre 3 .
-.It Fl V
-print version number and then exit
+regular expression compilation was successful.
.It Fl e Ar expression
Use the expression provided in the argument as the expression
to be compiled.
@@ -96,17 +73,40 @@ Perform matching until N matches are fou
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
+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.
+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.
+The default is to print the whole match, subexpression 0.
+.It Fl T Ar nospec|basic|extended
+Explicitly specify the type of matching to be performed.
+Possible values for this are
+.Dq nospec ,
+.Dq basic ,
+and
+.Dq extended .
+The default in
+.Nm
+is to use extended regular expressions by default.
+There is no default regular expression type in
+.Xr libagcre 3 .
.It Fl t
-trace the execution of
+Trace the execution of
.Fn agcre_regexec
by producing tracing information on
.Dv stderr .
+.It Fl V
+Print version number and then exit.
.It Fl v
-Perform an inverse match, showing all lines whihc do not match the
+Perform an inverse match, showing all lines which do not match the
regular expression.
.El
.Pp
@@ -117,10 +117,6 @@ utility uses the
library to perform textual matches on files and standard input
in the same way as
.Xr grep 1 .
-.Sh EXAMPLES
-.Bd -literal -offset indent
-.Ed
-.Pp
.Sh SEE ALSO
.Xr grep 1 ,
.Xr libagcre 3 ,
