Module Name: othersrc
Committed By: wiz
Date: Thu Aug 17 11:03:21 UTC 2017
Modified Files:
othersrc/external/bsd/agcre/dist: libagcre.3
Log Message:
Use more markup.
To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 othersrc/external/bsd/agcre/dist/libagcre.3
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/libagcre.3
diff -u othersrc/external/bsd/agcre/dist/libagcre.3:1.1 othersrc/external/bsd/agcre/dist/libagcre.3:1.2
--- othersrc/external/bsd/agcre/dist/libagcre.3:1.1 Wed Aug 16 23:38:13 2017
+++ othersrc/external/bsd/agcre/dist/libagcre.3 Thu Aug 17 11:03:21 2017
@@ -1,4 +1,4 @@
-.\" $NetBSD: libagcre.3,v 1.1 2017/08/16 23:38:13 agc Exp $
+.\" $NetBSD: libagcre.3,v 1.2 2017/08/17 11:03:21 wiz Exp $
.\"
.\" Copyright (c) 2017 Alistair Crooks <[email protected]>
.\" All rights reserved.
@@ -63,7 +63,7 @@ It will compile expressions described in
as well as some extensions.
.Pp
A
-.Dv agcre_regex_t
+.Vt agcre_regex_t
structure can either be allocated on the stack, or
it can be allocated dynamically using
.Fn agcre_new
@@ -78,52 +78,52 @@ Various flags can be specified during co
alter the regular expression which is produced.
These flags are:
.Bl -tag -width AGCRE_REG_EXTENDEDXXX
-.It AGCRE_REG_BASIC
+.It Dv AGCRE_REG_BASIC
Use basic regular expressions.
These are prserved for legacy reasons; no new code should use basic
regular expressions.
-For more information on regular expression formats, please refer to
+For more information on regular expression formats, please refer to
.Xr agcre_format 7 .
-.It AGCRE_REG_EXTENDED
+.It Dv AGCRE_REG_EXTENDED
Extended regular expressions are the standard form of searching,
and should be used.
-.It AGCRE_REG_NOSUB
+.It Dv AGCRE_REG_NOSUB
When searching through text, the standard searches are perfomed,
but no subexpression information will be returned.
-.It AGCRE_REG_NEWLINE
+.It Dv AGCRE_REG_NEWLINE
Normally newline characters are treated as a standard character.
With this flag, the zero width match for
.Dq ^
before the newline character will match, as will the zero width string
after the
.Dq $ .
-.It AGCRE_REG_NOSPEC
+.It Dv AGCRE_REG_NOSPEC
A standard search text will be performed, and no special characters
will be recognised.
In the current implementation, this will be performed using
a Horspool-modified Boyer-Moore search.
-.It AGCRE_REG_PEND
+.It Dv AGCRE_REG_PEND
Normally, the end of the string to be compiled will be the
first ASCII NUL character encountered.
With this flag, the
.Dv re_endp
field in the
-.Dv agcre_regex_t
+.Vt agcre_regex_t
structure will be used to point to the last position in
the string to be compiled.
-.It AGCRE_REG_DUMP
+.It Dv AGCRE_REG_DUMP
The current implementation builds a virtual machine to recognise the
regular expression.
This flag means that, after successful compilation of the
expression, the individual virtual machine instructions
will be printed on standard output.
-.It AGCRE_REG_TRACE
-traces execution of the regular expression.
-.It AGCRE_REG_LARGE
-is deprecated, and only recognised for legacy reasons.
-.It AGCRE_REG_BACKR
-is deprecated, and only recognised for legacy reasons.
-.\".It AGCRE_IN_8BITS
+.It Dv AGCRE_REG_TRACE
+Traces execution of the regular expression.
+.It Dv AGCRE_REG_LARGE
+Is deprecated, and only recognised for legacy reasons.
+.It Dv AGCRE_REG_BACKR
+Is deprecated, and only recognised for legacy reasons.
+.\".It Dv AGCRE_IN_8BITS
.\"This indicates to the
.\".Fn agcre_regcomp
.\"function that the string which will be parsed
@@ -131,13 +131,13 @@ is deprecated, and only recognised for l
.\"This is the default
.\".Dq width
.\"of the string expression.
-.\".It AGCRE_IN_16BITS
+.\".It Dv AGCRE_IN_16BITS
.\"This indicates to the
.\".Fn agcre_regcomp
.\"function that the string which will be parsed
.\"as a regular expression has been passed as an array of 16bit
.\"integers.
-.\".It AGCRE_IN_32BITS
+.\".It Dv AGCRE_IN_32BITS
.\"This indicates to the
.\".Fn agcre_regcomp
.\"function that the string which will be parsed
@@ -150,13 +150,13 @@ can be executed on different input using
.Fn agcre_regexec .
Various flags govern the matching behavior - these are:
.Bl -tag -width AGCRE_REG_EXTENDEDXXX
-.It AGCRE_REG_ICASE
+.It Dv AGCRE_REG_ICASE
When searching through text, a case-insensitive search will be
performed.
In contrast to other regular expression libraries,
case insensitivity does not need to be specified at expression compile time,
only at expression execution time.
-.It AGCRE_REG_NOTBOL
+.It Dv AGCRE_REG_NOTBOL
Normally, the sub-string passed to
.Fn agcre_regexec
is assumed to be the start of the whole string, and
@@ -164,7 +164,7 @@ is assumed to be the start of the whole
matching will be performed in the standard way.
With this flag, beginning of line matching will
be suppressed.
-.It AGCRE_REG_NOTEOL
+.It Dv AGCRE_REG_NOTEOL
Normally, the sub-string passed to
.Fn agcre_regexec
is assumed to be the end of the whole string, and
@@ -172,7 +172,7 @@ is assumed to be the end of the whole st
matching will be performed in the standard way.
With this flag, end of line matching will
be suppressed.
-.It AGCRE_REG_STARTEND
+.It Dv AGCRE_REG_STARTEND
The string passed to
.Fn agcre_regexec
is normally assumed to start at the first character, and to
@@ -186,7 +186,7 @@ and
fields provided in the zero-th element of the
.Fa matchv
argument.
-.\".It AGCRE_IN_8BITS
+.\".It Dv AGCRE_IN_8BITS
.\"This indicates to the
.\".Fn agcre_regexec
.\"function that the string which will be parsed
@@ -194,13 +194,13 @@ argument.
.\"This is the default
.\".Dq width
.\"of the string expression.
-.\".It AGCRE_IN_16BITS
+.\".It Dv AGCRE_IN_16BITS
.\"This indicates to the
.\".Fn agcre_regexec
.\"function that the string which will be parsed
.\"as a regular expression has been passed as an array of 16bit
.\"integers.
-.\".It AGCRE_IN_32BITS
+.\".It Dv AGCRE_IN_32BITS
.\"This indicates to the
.\".Fn agcre_regexec
.\"function that the string which will be parsed
@@ -239,8 +239,7 @@ which can be compiled.
However, to avoid abuse, certain arbitrary limits are set:
.Bl -tag -width characterXXX
.It tokens
-the maximum number of tokens is set at compile-time
-to 65536
+the maximum number of tokens is set at compile-time to 65536
.It sets
the maximum number of sets is set at compile-time to 1024
.El
