Upgrade grep version 2.9 to 2.12 on the vendor branch
[dragonfly.git] / contrib / grep / README
1   Copyright (C) 1992, 1997-2002, 2004-2012 Free Software Foundation, Inc.
2
3   Copying and distribution of this file, with or without modification,
4   are permitted in any medium without royalty provided the copyright
5   notice and this notice are preserved.
6
7 This is GNU grep, the "fastest grep in the west" (we hope).  All
8 bugs reported in previous releases have been fixed.  Many exciting new
9 bugs have probably been introduced in this revision.
10
11 GNU grep is provided "as is" with no warranty.  The exact terms
12 under which you may use and (re)distribute this program are detailed
13 in the GNU General Public License, in the file COPYING.
14
15 GNU grep is based on a fast lazy-state deterministic matcher (about
16 twice as fast as stock Unix egrep) hybridized with a Boyer-Moore-Gosper
17 search for a fixed string that eliminates impossible text from being
18 considered by the full regexp matcher without necessarily having to
19 look at every character.  The result is typically many times faster
20 than Unix grep or egrep.  (Regular expressions containing backreferencing
21 will run more slowly, however.)
22
23 See the files AUTHORS and THANKS for a list of authors and other contributors.
24
25 See the file INSTALL for compilation and installation instructions.
26
27 See the file NEWS for a description of major changes in this release.
28
29 See the file TODO for ideas on how you could help us improve grep.
30
31 See the file README-alpha for information on grep development and the CVS
32   repository.
33
34 Send bug reports to bug-grep@gnu.org.
35
36 KNOWN BUGS:
37
38 Several tests in fmbtest.sh and foad1.sh fail under the cs_CZ.UTF-8 locale
39 and have been disabled.
40
41 The combination of -o and -i options is broken and the known failing cases
42 are disabled in foad1.sh
43
44 The option -i does not work properly in some multibyte locales such as
45 tr_TR.UTF-8 where the upper case and lower case forms of a character are not
46 necessarily of the same byte length.
47
48 Additional bug reports can be found at:
49
50         http://savannah.gnu.org/bugs/?group=grep
51
52 You can also browse the bug-grep mailing list archive at:
53
54         http://lists.gnu.org/archive/html/bug-grep/
55
56 For any copyright year range specified as YYYY-ZZZZ in this package
57 note that the range specifies every single year in that closed interval.