1 | This directory holds files required to build GNU Sed for |
---|
2 | MS-DOS/MS-Windows using DJGPP tools. |
---|
3 | |
---|
4 | 1. Prerequisites |
---|
5 | ============= |
---|
6 | |
---|
7 | To configure and build GNU Sed, you will need to install the |
---|
8 | following: |
---|
9 | |
---|
10 | - The basic DJGPP development environment (gcc, Binutils, and |
---|
11 | djdevNNN.zip, where NNN is the version number); |
---|
12 | |
---|
13 | - A port of GNU Bash (make sure you have sh.exe as a ``symlink'' |
---|
14 | to bash.exe); |
---|
15 | |
---|
16 | - A port of GNU Make version 3.75 or later; |
---|
17 | |
---|
18 | - Auxiliary packages: GNU Fileutils, Textutils, Grep, and |
---|
19 | Diffutils; |
---|
20 | |
---|
21 | - A port of Sed. |
---|
22 | |
---|
23 | All of the above should be available from the DJGPP sites on |
---|
24 | SimTel.NET mirrors, in the v2gnu directory. |
---|
25 | |
---|
26 | 2. Bootstrapping Sed |
---|
27 | ================= |
---|
28 | |
---|
29 | If you cannot get hold of a working Sed, you can use the |
---|
30 | bootstrap.bat batch file to build a temporary version, suitable |
---|
31 | for running the configure script and the Makefiles it creates. |
---|
32 | bootstrap.bat requires only the compiler, the linker, and the C |
---|
33 | library. Once bootstrap.bat finishes, install the produced |
---|
34 | sed.exe somewhere along your PATH, build a production version like |
---|
35 | explained below, and install it instead of the temporary one. |
---|
36 | |
---|
37 | |
---|
38 | 3. Configuring |
---|
39 | =========== |
---|
40 | |
---|
41 | To configure Sed for DJGPP, run the config.bat batch file from the |
---|
42 | top directory, like this: |
---|
43 | |
---|
44 | djgpp\config |
---|
45 | |
---|
46 | If you are building Sed from another directory, supply the Sed |
---|
47 | source directory as an argument to config.bat: |
---|
48 | |
---|
49 | d:\src\sed-3.01\djgpp\config d:/src/sed-3.01 |
---|
50 | |
---|
51 | (Note the forward slashes: you MUST use them, or configuration |
---|
52 | process might fail.) |
---|
53 | |
---|
54 | config.bat will set some variables, update several files, then run |
---|
55 | the configure script via Bash, and create config.h header and |
---|
56 | Makefile's in various subdirectories. |
---|
57 | |
---|
58 | |
---|
59 | 4. Compiling |
---|
60 | ========= |
---|
61 | |
---|
62 | To compile, just type "make [Enter]". This builds the Sed |
---|
63 | executable. |
---|
64 | |
---|
65 | |
---|
66 | 5. Testing |
---|
67 | ======= |
---|
68 | |
---|
69 | This distribution has a test suite. To run the tests, type |
---|
70 | "make check CMP='diff -c'". This requires a Diff program (from |
---|
71 | Diffutils, see above). All tests should succeed. |
---|
72 | |
---|
73 | |
---|
74 | 6. Installation |
---|
75 | ============ |
---|
76 | |
---|
77 | To install, copy sed.exe to some directory along your PATH. Then |
---|
78 | copy the Info docs file doc/sed.info into your Info directory and |
---|
79 | run the install-info program to update your info/DIR file: |
---|
80 | |
---|
81 | install-info --info-dir=%DJDIR%/info %DJDIR%/info/sed.info |
---|
82 | |
---|
83 | (Replace %DJDIR% with the full path to the root of your DJGPP |
---|
84 | installation tree.) |
---|
85 | |
---|
86 | Alternatively, you could say "make install" and have Make do the |
---|
87 | entire installation routine for you. |
---|
88 | |
---|
89 | |
---|
90 | Enjoy, |
---|
91 | |
---|
92 | Eli Zaretskii <eliz@is.elta.co.il> |
---|