README
1This is GNU grep, the "fastest grep in the west" (we hope). All
2bugs reported in previous releases have been fixed. Many exciting new
3bugs have probably been introduced in this revision.
4
5GNU grep is provided "as is" with no warranty. The exact terms
6under which you may use and (re)distribute this program are detailed
7in the GNU General Public License, in the file COPYING.
8
9GNU grep is based on a fast lazy-state deterministic matcher (about
10twice as fast as stock Unix egrep) hybridized with a Boyer-Moore-Gosper
11search for a fixed string that eliminates impossible text from being
12considered by the full regexp matcher without necessarily having to
13look at every character. The result is typically many times faster
14than Unix grep or egrep. (Regular expressions containing backreferencing
15will run more slowly, however.)
16
17See the files AUTHORS and THANKS for a list of authors and other contributors.
18
19See the file INSTALL for compilation and installation instructions.
20
21See the file NEWS for a description of major changes in this release.
22
23See the file TODO for ideas on how you could help us improve grep.
24
25Send bug reports to bug-gnu-utils@gnu.org. Be sure to
26include the word "grep" in your Subject: header field.
27
README-alpha
1Newer ALPHA versions of this code are available through
2anonymous CVS:
3
4$ cvs -d :pserver:anoncvs@subversions.gnu.org:/cvs checkout grep
5
6If you are using an old version of cvs, you might have to run
7$ cvs -d :pserver:anoncvs@subversions.gnu.org:/cvs login
8first (and just press enter at the password prompt).
9
10Please send comments and problem reports to <bug-grep@gnu.org>.
11
README.DOS
1GREP DJGPP README
2=================
3
4To compile the Grep package with DJGPP tools, you will need the
5following tools (the names of the archives on DJGPP ftp sites where
6these tools are available are in parentheses):
7
8 - The basic DJGPP development environment, including the
9 GCC compiler and the libraries (v2gnu/gccNNNb.zip,
10 v2gnu/bnuNNNb.zip, v2/djdevNNN.zip).
11
12 - GNU Make revision 3.75 or later (v2gnu/makNNNb.zip).
13
14 - GNU Bash (v2gnu/bshNNNb.zip).
15
16 - GNU Sed (v2gnu/sedNNNb.zip).
17
18 - GNU M4 (v2gnu/m4-NNNb.zip).
19
20 - GNU Fileutils (v2gnu/filNNNb.zip), Textutils
21 (v2gnu/txtNNNb.zip) and Diffutils (v2gnu/difNNNb.zip).
22
23 - A (previous version of) GNU Grep (v2gnu/grepNNb.zip).
24
25Running the tests ("make check" in the top-level directory)
26additionally requires Gawk (v2gnu/gwkNNNb.zip). TAGS and ID targets
27require `etags' (from the Emacs distribution) and `mkid' (from
28ID-utils, v2gnu/iduNNb.zip), respectively.
29
30All of these tools are available from the DJGPP archive sites.
31
32To build Grep:
33 sh autogen.sh
34 sh configure
35 make
36
37
38Source distributions on DJGPP sites usually come pre-configured, so
39all you need to do in order to build the programs is to say "make".
40However, source distributions on GNU ftp sites, like ftp.gnu.org,
41need to be configured by running sh configure. You will also need
42to run it if you need to configure Grep differently than for the
43default configuration, for example if you want to install the programs
44in a directory other than the bin subdirectory of your DJGPP
45installation.
46
47To test that the package works, say "make check". If you don't have a
48file named sh.exe somewhere on your PATH, "make check" will refuse to
49run, as it needs a Unix-like shell.
50
51To install, either copy the executables and man pages to the
52appropriate directories, or say "make install". To clean up, say
53"make clean" or "make distclean".
54
55Please note the -u and -U options that specifically target MS-DOS and
56MS-Windows environments. They are described in the Grep man page in
57this distribution.
58
59National Language Support doesn't work in this port, so don't expect
60the programs to talk to you in any language but English.
61
62Please post any problems in the DOS version to the comp.os.msdos.djgpp
63news group first, especially if they have something to do with the
64DOS-specific aspects.
65
66To create the files required for the documentation package
67perform the following in the docs directory:
68 make grep.dvi
69 make grep.ps
70 makeinfo --html grep.texi -o grep.html
71
72
732.5f ported by Andrew Cottrell <anddjgpp@ihug.com.au>
74
75Enjoy,
76 Eli Zaretskii <eliz@is.elta.co.il>
77