--- code/trunk/doc/html/pcregrep.html 2010/11/17 17:55:57 572 +++ code/trunk/doc/html/pcregrep.html 2010/11/24 17:39:25 579 @@ -366,12 +366,12 @@ used. There is no short form for this option.

---match-limit=number +--match-limit=number Processing some regular expression patterns can require a very large amount of memory, leading in some cases to a program crash if not enough is available. -Other patterns may take a very long time to search for all possible matching +Other patterns may take a very long time to search for all possible matching strings. The pcre_exec() function that is called by pcregrep to do -the matching has two parameters that can limit the resources that it uses. +the matching has two parameters that can limit the resources that it uses.

The --match-limit option provides a means of limiting resource usage @@ -392,7 +392,7 @@ of use only if it is set smaller than --match-limit.

-There are no short forms for these options. The default settings are specified +There are no short forms for these options. The default settings are specified when the PCRE library is compiled, with the default default being 10 million.

@@ -451,13 +451,13 @@

-onumber, --only-matching=number -Show only the part of the line that matched the capturing parentheses of the +Show only the part of the line that matched the capturing parentheses of the given number. Up to 32 capturing parentheses are supported. Because these options can be given without an argument (see above), if an argument is present, it must be given in the same shell item, for example, -o3 or ---only-matching=2. The comments given for the non-argument case above also -apply to this case. If the specified capturing parentheses do not exist in the -pattern, or were not set in the match, nothing is output unless the file name +--only-matching=2. The comments given for the non-argument case above also +apply to this case. If the specified capturing parentheses do not exist in the +pattern, or were not set in the match, nothing is output unless the file name or line number are being printed.

@@ -554,8 +554,8 @@ -f/some/file -f /some/file -The exception is the -o option, which may appear with or without data. -Because of this, if data is present, it must follow immediately in the same +The exception is the -o option, which may appear with or without data. +Because of this, if data is present, it must follow immediately in the same item, for example -o3.

@@ -575,7 +575,7 @@ The exceptions to the above are the --colour (or --color) and --only-matching options, for which the data is optional. If one of these options does have data, it must be given in the first form, using an equals -character. Otherwise \fBpcregrep\P will assume that it has no data. +character. Otherwise pcregrep will assume that it has no data.


MATCHING ERRORS

@@ -590,7 +590,7 @@

The --match-limit option of pcregrep can be used to set the overall resource limit; there is a second option called --recursion-limit that -sets a limit on the amount of memory (usually stack) that is used (see the +sets a limit on the amount of memory (usually stack) that is used (see the discussion of these options above).


DIAGNOSTICS