@@ -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
10571058MATCHING 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
10741075DIAGNOSTICS
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