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