Ignore grep unit test
[product/upstream/grep.git] / README.DOS
1 GREP DJGPP README\r
2 =================\r
3 \r
4 To compile the GNU grep package with DJGPP tools, you will need the\r
5 following tools (the names of the archives on DJGPP ftp sites where\r
6 these tools are available are in parentheses):\r
7 \r
8           -  The basic DJGPP development environment, including the\r
9              GCC compiler and the libraries (v2gnu/gccNNNb.zip,\r
10              v2gnu/bnuNNNb.zip, v2/djdevNNN.zip).\r
11 \r
12           -  GNU Make revision 3.75 or later (v2gnu/makNNNb.zip).\r
13 \r
14           -  GNU Bash (v2gnu/bshNNNb.zip).\r
15 \r
16           -  GNU Sed (v2gnu/sedNNNb.zip).\r
17 \r
18           -  GNU M4 (v2gnu/m4-NNNb.zip).\r
19 \r
20           -  GNU Fileutils (v2gnu/filNNNb.zip), Textutils\r
21              (v2gnu/txtNNNb.zip) and Diffutils (v2gnu/difNNNb.zip).\r
22 \r
23           -  A (previous version of) GNU grep (v2gnu/grepNNb.zip).\r
24 \r
25 Running the tests ("make check" in the top-level directory)\r
26 additionally requires Gawk (v2gnu/gwkNNNb.zip).  TAGS and ID targets\r
27 require `etags' (from the Emacs distribution) and `mkid' (from\r
28 ID-utils, v2gnu/iduNNb.zip), respectively.\r
29 \r
30 All of these tools are available from the DJGPP archive sites.\r
31 \r
32 To build grep:\r
33           sh autogen.sh\r
34       sh configure\r
35           make\r
36 \r
37 \r
38 Source distributions on DJGPP sites usually come pre-configured, so\r
39 all you need to do in order to build the programs is to say "make".\r
40 However, source distributions on GNU ftp sites, like ftp.gnu.org,\r
41 need to be configured by running sh configure.  You will also need\r
42 to run it if you need to configure grep differently than for the\r
43 default configuration, for example if you want to install the programs\r
44 in a directory other than the bin subdirectory of your DJGPP\r
45 installation.\r
46 \r
47 To test that the package works, say "make check".  If you don't have a\r
48 file named sh.exe somewhere on your PATH, "make check" will refuse to\r
49 run, as it needs a Unix-like shell.\r
50 \r
51 To install, either copy the executables and man pages to the\r
52 appropriate directories, or say "make install".  To clean up, say\r
53 "make clean" or "make distclean".\r
54 \r
55 Please note the -u and -U options that specifically target MS-DOS and\r
56 MS-Windows environments.  They are described in the grep man page in\r
57 this distribution.\r
58 \r
59 National Language Support doesn't work in this port, so don't expect\r
60 the programs to talk to you in any language but English.\r
61 \r
62 Please post any problems in the DOS version to the comp.os.msdos.djgpp\r
63 news group first, especially if they have something to do with the\r
64 DOS-specific aspects.\r
65 \r
66 To create the files required for the documentation package\r
67 perform the following in the docs directory:\r
68         make grep.dvi\r
69         make grep.ps\r
70         makeinfo --html grep.texi -o grep.html\r
71 \r
72 \r
73 2.5f ported by Andrew Cottrell <anddjgpp@ihug.com.au>\r
74 \r
75 Enjoy,\r
76                                 Eli Zaretskii <eliz@is.elta.co.il>\r