|
Chris@0
|
1 Installation Instructions
|
|
Chris@0
|
2 =========================
|
|
Chris@0
|
3
|
|
Chris@0
|
4 Basic Installation
|
|
Chris@0
|
5 ------------------
|
|
Chris@0
|
6
|
|
Chris@0
|
7 Building this software requires only Python. To install with default options:
|
|
Chris@0
|
8
|
|
Chris@0
|
9 ./waf configure
|
|
Chris@0
|
10 ./waf
|
|
Chris@0
|
11 ./waf install
|
|
Chris@0
|
12
|
|
Chris@0
|
13 You may need to become root for the install stage, for example:
|
|
Chris@0
|
14
|
|
Chris@0
|
15 sudo ./waf install
|
|
Chris@0
|
16
|
|
Chris@0
|
17 Configuration Options
|
|
Chris@0
|
18 ---------------------
|
|
Chris@0
|
19
|
|
Chris@0
|
20 All supported options can be viewed using the command:
|
|
Chris@0
|
21
|
|
Chris@0
|
22 ./waf --help
|
|
Chris@0
|
23
|
|
Chris@0
|
24 Most options only need to be passed during the configure stage, for example:
|
|
Chris@0
|
25
|
|
Chris@0
|
26 ./waf configure --prefix=/usr
|
|
Chris@0
|
27 ./waf
|
|
Chris@0
|
28 ./waf install
|
|
Chris@0
|
29
|
|
Chris@0
|
30 Compiler Configuration
|
|
Chris@0
|
31 ----------------------
|
|
Chris@0
|
32
|
|
Chris@0
|
33 Several standard environment variables can be used to control how compilers are
|
|
Chris@0
|
34 invoked:
|
|
Chris@0
|
35
|
|
Chris@0
|
36 * CC: Path to C compiler
|
|
Chris@0
|
37 * CFLAGS: C compiler options
|
|
Chris@0
|
38 * CXX: Path to C++ compiler
|
|
Chris@0
|
39 * CXXFLAGS: C++ compiler options
|
|
Chris@0
|
40 * CPPFLAGS: C preprocessor options
|
|
Chris@0
|
41 * LINKFLAGS: Linker options
|
|
Chris@0
|
42
|
|
Chris@0
|
43 Installation Directories
|
|
Chris@0
|
44 ------------------------
|
|
Chris@0
|
45
|
|
Chris@0
|
46 The --prefix option (or the PREFIX environment variable) can be used to change
|
|
Chris@0
|
47 the prefix which all files are installed under. There are also several options
|
|
Chris@0
|
48 allowing for more fine-tuned control, see the --help output for details.
|
|
Chris@0
|
49
|
|
Chris@0
|
50 Packaging
|
|
Chris@0
|
51 ---------
|
|
Chris@0
|
52
|
|
Chris@0
|
53 Everything can be installed to a specific root directory by passing a --destdir
|
|
Chris@0
|
54 option to the install stage (or setting the DESTDIR environment variable),
|
|
Chris@0
|
55 which adds a prefix to all install paths. For example:
|
|
Chris@0
|
56
|
|
Chris@0
|
57 ./waf configure --prefix=/usr
|
|
Chris@0
|
58 ./waf
|
|
Chris@0
|
59 ./waf install --destdir=/tmp/package
|
