Add comment about binary zeros.

This commit is contained in:
Philip.Hazel 2016-04-06 08:19:45 +00:00
parent 992322039d
commit 1bcea9b2da
1 changed files with 11 additions and 7 deletions

View File

@ -1,4 +1,4 @@
.TH PCRE2GREP 1 "01 April 2016" "PCRE2 10.22" .TH PCRE2GREP 1 "06 April 2016" "PCRE2 10.22"
.SH NAME .SH NAME
pcre2grep - a grep with Perl-compatible regular expressions. pcre2grep - a grep with Perl-compatible regular expressions.
.SH SYNOPSIS .SH SYNOPSIS
@ -675,7 +675,7 @@ following substrings specifying arguments:
.sp .sp
executable_name|arg1|arg2|... executable_name|arg1|arg2|...
.sp .sp
Any substirng (including the executable name) may contain escape sequences Any substring (including the executable name) may contain escape sequences
started by a dollar character: $<digits> or ${<digits>} is replaced by the started by a dollar character: $<digits> or ${<digits>} is replaced by the
captured substring of the given decimal number, which must be greater than captured substring of the given decimal number, which must be greater than
zero. If the number is greater than the number of capturing substrings, or if zero. If the number is greater than the number of capturing substrings, or if
@ -695,10 +695,14 @@ a single dollar and $| is replaced by a pipe character. Here is an example:
Arg1: [1] [234] [4] Arg2: |1| () Arg1: [1] [234] [4] Arg2: |1| ()
12345 12345
.sp .sp
Any syntax errors in the string (for example, a dollar not followed by another The parameters for the \fBexecv()\fP system call that is used to run the
character) cause the callout to be ignored. If running the program fails for program or script are zero-terminated strings. This means that binary zero
any reason (including the non-existence of the executable), a local matching characters in the callout argument will cause premature termination of their
failure occurs and the matcher backtracks in the normal way. substrings, and therefore should not be present. Any syntax errors in the
string (for example, a dollar not followed by another character) cause the
callout to be ignored. If running the program fails for any reason (including
the non-existence of the executable), a local matching failure occurs and the
matcher backtracks in the normal way.
. .
. .
.SH "MATCHING ERRORS" .SH "MATCHING ERRORS"
@ -748,6 +752,6 @@ Cambridge, England.
.rs .rs
.sp .sp
.nf .nf
Last updated: 01 April 2016 Last updated: 06 April 2016
Copyright (c) 1997-2016 University of Cambridge. Copyright (c) 1997-2016 University of Cambridge.
.fi .fi