| 1 | Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002 Free Software
|
|---|
| 2 | Foundation, Inc.
|
|---|
| 3 |
|
|---|
| 4 | This file is free documentation; the Free Software Foundation gives
|
|---|
| 5 | unlimited permission to copy, distribute and modify it.
|
|---|
| 6 |
|
|---|
| 7 | Basic Installation
|
|---|
| 8 | ==================
|
|---|
| 9 |
|
|---|
| 10 | These are generic installation instructions.
|
|---|
| 11 |
|
|---|
| 12 | The `configure' shell script attempts to guess correct values for
|
|---|
| 13 | various system-dependent variables used during compilation. It uses
|
|---|
| 14 | those values to create a `Makefile' in each directory of the package.
|
|---|
| 15 | It may also create one or more `.h' files containing system-dependent
|
|---|
| 16 | definitions. Finally, it creates a shell script `config.status' that
|
|---|
| 17 | you can run in the future to recreate the current configuration, and a
|
|---|
| 18 | file `config.log' containing compiler output (useful mainly for
|
|---|
| 19 | debugging `configure').
|
|---|
| 20 |
|
|---|
| 21 | It can also use an optional file (typically called `config.cache'
|
|---|
| 22 | and enabled with `--cache-file=config.cache' or simply `-C') that saves
|
|---|
| 23 | the results of its tests to speed up reconfiguring. (Caching is
|
|---|
| 24 | disabled by default to prevent problems with accidental use of stale
|
|---|
| 25 | cache files.)
|
|---|
| 26 |
|
|---|
| 27 | If you need to do unusual things to compile the package, please try
|
|---|
| 28 | to figure out how `configure' could check whether to do them, and mail
|
|---|
| 29 | diffs or instructions to the address given in the `README' so they can
|
|---|
| 30 | be considered for the next release. If you are using the cache, and at
|
|---|
| 31 | some point `config.cache' contains results you don't want to keep, you
|
|---|
| 32 | may remove or edit it.
|
|---|
| 33 |
|
|---|
| 34 | The file `configure.ac' (or `configure.in') is used to create
|
|---|
| 35 | `configure' by a program called `autoconf'. You only need
|
|---|
| 36 | `configure.ac' if you want to change it or regenerate `configure' using
|
|---|
| 37 | a newer version of `autoconf'.
|
|---|
| 38 |
|
|---|
| 39 | The simplest way to compile this package is:
|
|---|
| 40 |
|
|---|
| 41 | 1. `cd' to the directory containing the package's source code and type
|
|---|
| 42 | `./configure' to configure the package for your system. If you're
|
|---|
| 43 | using `csh' on an old version of System V, you might need to type
|
|---|
| 44 | `sh ./configure' instead to prevent `csh' from trying to execute
|
|---|
| 45 | `configure' itself.
|
|---|
| 46 |
|
|---|
| 47 | Running `configure' takes awhile. While running, it prints some
|
|---|
| 48 | messages telling which features it is checking for.
|
|---|
| 49 |
|
|---|
| 50 | 2. Type `make' to compile the package.
|
|---|
|
|---|
