--- code/trunk/doc/pcregrep.txt 2007/02/24 21:39:33 49 +++ code/trunk/doc/pcregrep.txt 2007/02/24 21:40:03 63 @@ -2,18 +2,21 @@ pcregrep - a grep with Perl-compatible regular expressions. - SYNOPSIS - pcregrep [-Vchilnsvx] 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 @@ 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. @@ -37,6 +41,17 @@ wise have been printed. If several files are given, a count is printed for each of them. + -ffilename + 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. @@ -50,10 +65,19 @@ -n Precede each line by its line number in the file. + -r If any file is a directory, recursively scan the + files it contains. Without -r a directory is + scanned as a normal file. + -s Work silently, that is, display nothing except 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. @@ -66,15 +90,30 @@ 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). @@ -82,6 +121,10 @@ AUTHOR + Philip Hazel - Copyright (c) 1997-2000 University of Cambridge. + University Computing Service + Cambridge CB2 3QG, England. +Last updated: 03 February 2003 +Copyright (c) 1997-2003 University of Cambridge.