| | @@ -1,22 +1,21 @@ |
| 1 | | -To do a complete build on most unix systems, just type: |
| 2 | | - |
| 3 | | - make |
| 4 | | - |
| 5 | | -If you have an unusual unix system for which the standard Makefile |
| 6 | | -will not work, or if you want to do some non-standard options, you can |
| 7 | | -also run: |
| 1 | +To do a complete build, just type: |
| 8 | 2 | |
| 9 | 3 | ./configure; make |
| 10 | 4 | |
| 11 | | -The ./configure script builds GNUmakefile which will be used in place |
| 12 | | -of Makefile. Run "./configure --help" for a listing of the available |
| 13 | | -options. |
| 5 | +The ./configure script builds Makefile from Makefile.in based on |
| 6 | +your system and any options you select (run "./configure --help" |
| 7 | +for a listing of the available options.) |
| 8 | + |
| 9 | +If you wish to use the original Makefile with no configuration, you can |
| 10 | +instead use: |
| 11 | + |
| 12 | + make -f Makefile.classic |
| 14 | 13 | |
| 15 | 14 | On a windows box, use one of the Makefiles in the win/ subdirectory, |
| 16 | 15 | according to your compiler and environment. If you have GCC and MSYS |
| 17 | | -installed on your system, the consider: |
| 16 | +installed on your system, then consider: |
| 18 | 17 | |
| 19 | 18 | make -f win/Makefile.mingw |
| 20 | 19 | |
| 21 | 20 | If you have VC++ installed on your system, then consider: |
| 22 | 21 | |
| | @@ -31,24 +30,31 @@ |
| 31 | 30 | |
| 32 | 31 | BUILDING OUTSIDE THE SOURCE TREE |
| 33 | 32 | |
| 34 | 33 | An out of source build is pretty easy: |
| 35 | 34 | |
| 36 | | - 1. Make a new directory to do the builds in. |
| 37 | | - 2. Copy "Makefile" from the source into the build directory and |
| 38 | | - modify the SRCDIR macro along the lines of: |
| 35 | + 1. Make and change to a new directory to do the builds in. |
| 36 | + 2. Run the "configure" script from this directory. |
| 37 | + 3. Type: "make" |
| 38 | + |
| 39 | +For example: |
| 39 | 40 | |
| 40 | | - SRCDIR=../src |
| 41 | | - |
| 42 | | - 3. type: "make" |
| 41 | + mkdir build |
| 42 | + cd build |
| 43 | + ../configure |
| 44 | + make |
| 43 | 45 | |
| 44 | 46 | This will now keep all generates files seperate from the maintained |
| 45 | 47 | source code. |
| 46 | 48 | |
| 47 | 49 | -------------------------------------------------------------------------- |
| 48 | 50 | |
| 49 | 51 | Here are some notes on what is happening behind the scenes: |
| 52 | + |
| 53 | +* The configure script (if used) examines the options given |
| 54 | + and runs various tests with the C compiler to create Makefile |
| 55 | + from the Makefile.in template as well as autoconfig.h |
| 50 | 56 | |
| 51 | 57 | * The Makefile just sets up a few macros and then invokes the |
| 52 | 58 | real makefile in src/main.mk. The src/main.mk makefile is |
| 53 | 59 | automatically generated by a TCL script found at src/makemake.tcl. |
| 54 | 60 | Do not edit src/main.mk directly. Update src/makemake.tcl and |
| 55 | 61 | |
| 56 | 62 | DELETED GNUmakefile.in |
| 57 | 63 | DELETED Makefile |
| 58 | 64 | ADDED Makefile.classic |
| 59 | 65 | ADDED Makefile.in |