diff options
Diffstat (limited to 'doc/pcregrep.txt')
| -rw-r--r-- | doc/pcregrep.txt | 65 |
1 files changed, 47 insertions, 18 deletions
diff --git a/doc/pcregrep.txt b/doc/pcregrep.txt index 1600228..ebff1e3 100644 --- a/doc/pcregrep.txt +++ b/doc/pcregrep.txt @@ -2,18 +2,21 @@ NAME pcregrep - a grep with Perl-compatible regular expressions. - SYNOPSIS - pcregrep [-Vcfhilnrsvx] pattern [file] ... - + pcregrep [-Vcfhilnrsuvx] [long options] [pattern] [file1 DESCRIPTION + pcregrep searches files for character patterns, in the same way as other grep commands do, but it uses the PCRE regular expression library to support patterns that are compatible - with the regular expressions of Perl 5. See pcre(3) for a - full description of syntax and semantics. + with the regular expressions of Perl 5. See pcrepattern for + a full description of syntax and semantics of the regular + expressions that PCRE supports. + + A pattern must be specified on the command line unless the + -f option is used (see below). If no files are specified, pcregrep reads the standard input. By default, each line that matches the pattern is @@ -27,8 +30,9 @@ DESCRIPTION each line before it is matched against the pattern. - OPTIONS + + -V Write the version number of the PCRE library being used to the standard error stream. @@ -38,12 +42,15 @@ OPTIONS given, a count is printed for each of them. -ffilename - Read patterns from the file, one per line, and - match all patterns against each line. There is a - maximum of 100 patterns. Trailing white space is - removed, and blank lines are ignored. An empty - file contains no patterns and therefore matches - nothing. + Read a number of patterns from the file, one per + line, and match all of them against each line of + input. A line is output if any of the patterns + match it. When -f is used, no pattern is taken + from the command line; all arguments are treated + as file names. There is a maximum of 100 patterns. + Trailing white space is removed, and blank lines + are ignored. An empty file contains no patterns + and therefore matches nothing. -h Suppress printing of filenames when searching mul- tiple files. @@ -52,7 +59,6 @@ OPTIONS parisons. -l Instead of printing lines from the files, just - print the names of the files containing lines that would have been printed. Each file name is printed once, on a separate line. @@ -67,6 +73,11 @@ OPTIONS error messages. The exit status indicates whether any matches were found. + -u Operate in UTF-8 mode. This option is available + only if PCRE has been compiled with UTF-8 support. + Both the pattern and each subject line are assumed + to be valid strings of UTF-8 characters. + -v Invert the sense of the match, so that lines which do not match the pattern are now the ones that are found. @@ -79,15 +90,30 @@ OPTIONS the regular expression. +LONG OPTIONS -SEE ALSO - pcre(3), Perl 5 documentation - + Long forms of all the options are available, as in GNU grep. + They are shown in the following table: + -c --count + -h --no-filename + -i --ignore-case + -l --files-with-matches + -n --line-number + -r --recursive + -s --no-messages + -u --utf-8 + -V --version + -v --invert-match + -x --line-regex + -x --line-regexp + In addition, --file=filename is equivalent to -ffilename, + and --help shows the list of options and then exits. DIAGNOSTICS + Exit status is 0 if any matches were found, 1 if no matches were found, and 2 for syntax errors or inacessible files (even if matches were found). @@ -95,7 +121,10 @@ DIAGNOSTICS AUTHOR + Philip Hazel <ph10@cam.ac.uk> + University Computing Service + Cambridge CB2 3QG, England. - Last updated: 15 August 2001 - Copyright (c) 1997-2001 University of Cambridge. +Last updated: 03 February 2003 +Copyright (c) 1997-2003 University of Cambridge. |