aboutsummaryrefslogtreecommitdiffstats
path: root/external-libs/pcre/doc/pcregrep.txt
diff options
context:
space:
mode:
Diffstat (limited to 'external-libs/pcre/doc/pcregrep.txt')
-rw-r--r--external-libs/pcre/doc/pcregrep.txt124
1 files changed, 0 insertions, 124 deletions
diff --git a/external-libs/pcre/doc/pcregrep.txt b/external-libs/pcre/doc/pcregrep.txt
deleted file mode 100644
index aae8928f..00000000
--- a/external-libs/pcre/doc/pcregrep.txt
+++ /dev/null
@@ -1,124 +0,0 @@
-PCREGREP(1) PCREGREP(1)
-
-
-
-NAME
- pcregrep - a grep with Perl-compatible regular expressions.
-
-SYNOPSIS
- pcregrep [-Vcfhilnrsuvx] [long options] [pattern] [file1 file2 ...]
-
-
-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 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 copied to the standard
- output, and if there is more than one file, the file name is printed
- before each line of output. However, there are options that can change
- how pcregrep behaves.
-
- Lines are limited to BUFSIZ characters. BUFSIZ is defined in <stdio.h>.
- The newline character is removed from the end of 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.
-
- -c Do not print individual lines; instead just print a count of
- the number of lines that would otherwise 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 out-
- put 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 multiple files.
-
- -i Ignore upper/lower case distinctions during comparisons.
-
- -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.
-
- -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 mes-
- sages. 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.
-
- -x Force the pattern to be anchored (it must start matching at
- the beginning of the line) and in addition, require it to
- match the entire line. This is equivalent to having ^ and $
- characters at the start and end of each alternative branch in
- the regular expression.
-
-
-LONG OPTIONS
-
- 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).
-
-
-
-AUTHOR
-
- Philip Hazel <ph10@cam.ac.uk>
- University Computing Service
- Cambridge CB2 3QG, England.
-
-Last updated: 03 February 2003
-Copyright (c) 1997-2003 University of Cambridge.