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