xref: /dragonfly/contrib/grep/README (revision 09d4459f)
1*09d4459fSDaniel Fojt  Copyright (C) 1992, 1997-2002, 2004-2020 Free Software Foundation, Inc.
295b7b453SJohn Marino
395b7b453SJohn Marino  Copying and distribution of this file, with or without modification,
495b7b453SJohn Marino  are permitted in any medium without royalty provided the copyright
595b7b453SJohn Marino  notice and this notice are preserved.
695b7b453SJohn Marino
795b7b453SJohn MarinoThis is GNU grep, the "fastest grep in the west" (we hope).  All
895b7b453SJohn Marinobugs reported in previous releases have been fixed.  Many exciting new
995b7b453SJohn Marinobugs have probably been introduced in this revision.
1095b7b453SJohn Marino
1195b7b453SJohn MarinoGNU grep is provided "as is" with no warranty.  The exact terms
1295b7b453SJohn Marinounder which you may use and (re)distribute this program are detailed
1395b7b453SJohn Marinoin the GNU General Public License, in the file COPYING.
1495b7b453SJohn Marino
1595b7b453SJohn MarinoGNU grep is based on a fast lazy-state deterministic matcher (about
1695b7b453SJohn Marinotwice as fast as stock Unix egrep) hybridized with a Boyer-Moore-Gosper
1795b7b453SJohn Marinosearch for a fixed string that eliminates impossible text from being
1895b7b453SJohn Marinoconsidered by the full regexp matcher without necessarily having to
1995b7b453SJohn Marinolook at every character.  The result is typically many times faster
20*09d4459fSDaniel Fojtthan Unix grep or egrep.  (Regular expressions containing back-references
2195b7b453SJohn Marinowill run more slowly, however.)
2295b7b453SJohn Marino
2395b7b453SJohn MarinoSee the files AUTHORS and THANKS for a list of authors and other contributors.
2495b7b453SJohn Marino
2595b7b453SJohn MarinoSee the file INSTALL for compilation and installation instructions.
26dc7c36e4SJohn MarinoIf there is no INSTALL file, this copy of the source code is intended
27dc7c36e4SJohn Marinofor expert hackers; please see the file README-hacking.
2895b7b453SJohn Marino
2995b7b453SJohn MarinoSee the file NEWS for a description of major changes in this release.
3095b7b453SJohn Marino
3195b7b453SJohn MarinoSee the file TODO for ideas on how you could help us improve grep.
3295b7b453SJohn Marino
3395b7b453SJohn MarinoSee the file README-alpha for information on grep development and the CVS
3495b7b453SJohn Marino  repository.
3595b7b453SJohn Marino
3695b7b453SJohn MarinoSend bug reports to bug-grep@gnu.org.
3795b7b453SJohn Marino
3895b7b453SJohn MarinoKNOWN BUGS:
3995b7b453SJohn Marino
4095b7b453SJohn MarinoSeveral tests in fmbtest.sh and foad1.sh fail under the cs_CZ.UTF-8 locale
4195b7b453SJohn Marinoand have been disabled.
4295b7b453SJohn Marino
4395b7b453SJohn MarinoThe combination of -o and -i options is broken and the known failing cases
4495b7b453SJohn Marinoare disabled in foad1.sh
4595b7b453SJohn Marino
4695b7b453SJohn MarinoThe option -i does not work properly in some multibyte locales such as
4795b7b453SJohn Marinotr_TR.UTF-8 where the upper case and lower case forms of a character are not
4895b7b453SJohn Marinonecessarily of the same byte length.
4995b7b453SJohn Marino
50dc7c36e4SJohn MarinoA list of outstanding and resolved bugs can be found at:
5195b7b453SJohn Marino
52*09d4459fSDaniel Fojt        https://debbugs.gnu.org/cgi/pkgreport.cgi?package=grep
5395b7b453SJohn Marino
5495b7b453SJohn MarinoYou can also browse the bug-grep mailing list archive at:
5595b7b453SJohn Marino
56*09d4459fSDaniel Fojt        https://lists.gnu.org/r/bug-grep/
57200fbe8dSJohn Marino
58200fbe8dSJohn MarinoFor any copyright year range specified as YYYY-ZZZZ in this package
59200fbe8dSJohn Marinonote that the range specifies every single year in that closed interval.
60