Skip to content

Commit eb8737f

Browse files
Sync autogenerated files #noupdate
1 parent 0d579d3 commit eb8737f

File tree

1 file changed

+21
-20
lines changed

1 file changed

+21
-20
lines changed

doc/pcre2grep.txt

Lines changed: 21 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1030,7 +1030,8 @@ USING PCRE2'S CALLOUT FACILITY
10301030
quences started by a dollar character. These are the same as for the
10311031
--output (-O) option documented above, except that $0 or $& cannot in-
10321032
sert the matched string because the match is still in progress. In-
1033-
stead, the character substring, use $$ or $| respectively. Here is an
1033+
stead, the character '0' is inserted. If you need a literal dollar or
1034+
pipe character in any substring, use $$ or $| respectively. Here is an
10341035
example:
10351036

10361037
echo -e "abcde\n12345" | pcre2grep \
@@ -1044,43 +1045,43 @@ USING PCRE2'S CALLOUT FACILITY
10441045
Arg1: [1] [234] [4] Arg2: |1| ()
10451046
12345
10461047

1047-
The parameters for the system call that is used to run the program or
1048+
The parameters for the system call that is used to run the program or
10481049
script are zero-terminated strings. This means that binary zero charac-
1049-
ters in the callout argument will cause premature termination of their
1050-
substrings, and therefore should not be present. Any syntax errors in
1051-
the string (for example, a dollar not followed by another character)
1050+
ters in the callout argument will cause premature termination of their
1051+
substrings, and therefore should not be present. Any syntax errors in
1052+
the string (for example, a dollar not followed by another character)
10521053
causes the callout to be ignored. If running the program fails for any
1053-
reason (including the non-existence of the executable), a local match-
1054+
reason (including the non-existence of the executable), a local match-
10541055
ing failure occurs and the matcher backtracks in the normal way.
10551056

10561057

10571058
MATCHING ERRORS
10581059

1059-
It is possible to supply a regular expression that takes a very long
1060-
time to fail to match certain lines. Such patterns normally involve
1061-
nested indefinite repeats, for example: (a+)*\d when matched against a
1062-
line of a's with no final digit. The PCRE2 matching function has a re-
1063-
source limit that causes it to abort in these circumstances. If this
1064-
happens, pcre2grep outputs an error message and the line that caused
1065-
the problem to the standard error stream. If there are more than 20
1060+
It is possible to supply a regular expression that takes a very long
1061+
time to fail to match certain lines. Such patterns normally involve
1062+
nested indefinite repeats, for example: (a+)*\d when matched against a
1063+
line of a's with no final digit. The PCRE2 matching function has a re-
1064+
source limit that causes it to abort in these circumstances. If this
1065+
happens, pcre2grep outputs an error message and the line that caused
1066+
the problem to the standard error stream. If there are more than 20
10661067
such errors, pcre2grep gives up.
10671068

1068-
The --match-limit option of pcre2grep can be used to set the overall
1069-
resource limit. There are also other limits that affect the amount of
1070-
memory used during matching; see the discussion of --heap-limit and
1069+
The --match-limit option of pcre2grep can be used to set the overall
1070+
resource limit. There are also other limits that affect the amount of
1071+
memory used during matching; see the discussion of --heap-limit and
10711072
--depth-limit above.
10721073

10731074

10741075
DIAGNOSTICS
10751076

10761077
Exit status is 0 if any matches were found, 1 if no matches were found,
1077-
and 2 for syntax errors, overlong lines, non-existent or inaccessible
1078-
files (even if matches were found in other files) or too many matching
1078+
and 2 for syntax errors, overlong lines, non-existent or inaccessible
1079+
files (even if matches were found in other files) or too many matching
10791080
errors. Using the -s option to suppress error messages about inaccessi-
10801081
ble files does not affect the return code.
10811082

1082-
When run under VMS, the return code is placed in the symbol
1083-
PCRE2GREP_RC because VMS does not distinguish between exit(0) and
1083+
When run under VMS, the return code is placed in the symbol
1084+
PCRE2GREP_RC because VMS does not distinguish between exit(0) and
10841085
exit(1).
10851086

10861087

0 commit comments

Comments
 (0)