=== modified file 'INSTALL' --- INSTALL 2009-11-25 17:37:04 +0000 +++ INSTALL 2009-12-05 06:26:21 +0000 @@ -12,9 +12,9 @@ configuring the GRUB. * GCC 4.1.3 or later -* GNU Make +* GNU Make 3.81 or later * GNU Bison 2.3 or later -* GNU binutils 2.9.1.0.23 or later +* GNU Binutils 2.18 or later * Other standard GNU/Unix tools If you use a development snapshot or want to hack on GRUB you may @@ -22,8 +22,11 @@ * Ruby 1.6 or later * Python 2.5.2 or later -* Autoconf 2.60 or later -* Automake 1.10.1 or later +* GNU Autoconf 2.60 or later +* GNU Automake 1.10.1 or later +* Fontconfig 2.6.0 or later +* GNU Ncurses 5.7 or later +* Libusb 0.9 or later Configuring the GRUB ==================== @@ -52,27 +55,28 @@ Building the GRUB ================= -The simplest way to compile this package is: +The recommended way to compile this package is: - 1. `cd' to the directory containing the package's source code. If - you don't use a release tarball you have to type `./autogen.sh'. - Type `./configure' to configure the package for your system. + 1. `cd' to the directory containing the package's source code. + + 2. If you don't use a release tarball you have to type `sh autogen.sh'. + + 3. Create a build directory, `mkdir -p build; cd build' + + 4. Type `../configure' to configure the package for your system. If you're using `csh' on an old version of System V, you might - need to type `sh ./configure' instead to prevent `csh' from trying + need to type `sh ../configure' instead to prevent `csh' from trying to execute `configure' itself. - Running `configure' takes awhile. While running, it prints some - messages telling which features it is checking for. - - 2. Type `make' to compile the package. - - 3. Optionally, type `make check' to run any self-tests that come with - the package. - - 4. Type `make install' to install the programs and any data files and + While running, `configure' prints messages telling which + features it is checking. + + 5. Type `make' to compile the package. + + 6. Type `make install' to install the programs and, data files, and documentation. - 5. You can remove the program binaries and object files from the + 7. You can remove the program binaries and object files from the source code directory by typing `make clean'. To also remove the files that `configure' created (so you can compile the package for a different kind of computer), type `make distclean'. There is @@ -106,14 +110,14 @@ use PATH as the prefix for installing programs and libraries. Documentation and other data files will still use the regular prefix. -In addition, if you use an unusual directory layout you can give -options like `--bindir=PATH' to specify different values for -particular kinds of files. Run `configure --help' for a list of the +In addition, if you use an unusual directory layout you can give options +like `--bindir=PATH1' or `--sysconfdir=PATH2' to specify different values +for particular kinds of files. Run `configure --help' for a list of the directories you can set and what kinds of files go in them. -If the package supports it, you can cause programs to be installed -with an extra prefix or suffix on their names by giving `configure' -the option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'. +You can cause programs to be installed with an extra prefix or suffix on +their names by giving `configure' the option `--program-prefix=PREFIX' +or `--program-suffix=SUFFIX'. Please note, however, that the GRUB knows where it is located in the filesystem. If you have installed it in an unusual location, the @@ -121,7 +125,6 @@ options for the GRUB is to allow you to "install" in some alternate location, and then copy these to the actual root filesystem later. - Sharing Defaults ================ @@ -137,13 +140,37 @@ Operation Controls ================== - `configure' recognizes the following options to control how it -operates. + `configure' recognizes the following options to control how GRUB +is built. If the prerequsite requirements are not present for +the options below, the associated programs will not be built, but +configure will succeed. + +`--enable-efiemu' + Build and install the efiemu runtimes (default=yes). + Requires an x86-64 system. + +`--enable-mm-debug' + Include memory manager debugging (default=no). + +`--enable-grub-emu' + Build and install the `grub-emu' debugging utility (default=yes). + Requires Ncurses. + +`--enable-grub-emu-usb' + Build and install the `grub-emu' debugging utility with USB support + (default=yes). Requires grub-emu and Libusb. + +`--enable-grub-fstest' + Build and install the `grub-fstest' debugging utility (default=yes) + +`--enable-grub-mkfont' + Build and install the `grub-mkfont' utility (default=yes). + Requires Fontconfig. `--cache-file=FILE' Use and save the results of the tests in FILE instead of - `./config.cache'. Set FILE to `/dev/null' to disable caching, for - debugging `configure'. + `./config.cache'. Set FILE to `/dev/null' to disable caching for + debugging of `configure'. `--help' Print a summary of the options to `configure', and exit. @@ -158,5 +185,7 @@ `configure' can determine that directory automatically. `--version' +`-V' Print the version of Autoconf used to generate the `configure' script, and exit. +