bash: Basic Installation
1
1 10.1 Basic Installation
1 =======================
1
1 These are installation instructions for Bash.
1
1 The simplest way to compile Bash is:
1
1 1. 'cd' to the directory containing the source code and type
1 './configure' to configure Bash for your system. If you're using
1 'csh' on an old version of System V, you might need to type 'sh
1 ./configure' instead to prevent 'csh' from trying to execute
1 'configure' itself.
1
1 Running 'configure' takes some time. While running, it prints
1 messages telling which features it is checking for.
1
1 2. Type 'make' to compile Bash and build the 'bashbug' bug reporting
1 script.
1
1 3. Optionally, type 'make tests' to run the Bash test suite.
1
1 4. Type 'make install' to install 'bash' and 'bashbug'. This will
1 also install the manual pages and Info file.
1
1 The 'configure' shell script attempts to guess correct values for
1 various system-dependent variables used during compilation. It uses
1 those values to create a 'Makefile' in each directory of the package
1 (the top directory, the 'builtins', 'doc', and 'support' directories,
1 each directory under 'lib', and several others). It also creates a
1 'config.h' file containing system-dependent definitions. Finally, it
1 creates a shell script named 'config.status' that you can run in the
1 future to recreate the current configuration, a file 'config.cache' that
1 saves the results of its tests to speed up reconfiguring, and a file
1 'config.log' containing compiler output (useful mainly for debugging
1 'configure'). If at some point 'config.cache' contains results you
1 don't want to keep, you may remove or edit it.
1
1 To find out more about the options and arguments that the 'configure'
1 script understands, type
1
1 bash-2.04$ ./configure --help
1
1 at the Bash prompt in your Bash source directory.
1
1 If you need to do unusual things to compile Bash, please try to
1 figure out how 'configure' could check whether or not to do them, and
1 mail diffs or instructions to <bash-maintainers@gnu.org> so they can be
1 considered for the next release.
1
1 The file 'configure.ac' is used to create 'configure' by a program
1 called Autoconf. You only need 'configure.ac' if you want to change it
1 or regenerate 'configure' using a newer version of Autoconf. If you do
1 this, make sure you are using Autoconf version 2.50 or newer.
1
1 You can remove the program binaries and object files from the source
1 code directory by typing 'make clean'. To also remove the files that
1 'configure' created (so you can compile Bash for a different kind of
1 computer), type 'make distclean'.
1