Chris@0: Installation Instructions
Chris@0: =========================
Chris@0: 
Chris@0: Basic Installation
Chris@0: ------------------
Chris@0: 
Chris@0: Building this software requires only Python.  To install with default options:
Chris@0: 
Chris@0:     ./waf configure
Chris@0:     ./waf
Chris@0:     ./waf install
Chris@0: 
Chris@0: You may need to become root for the install stage, for example:
Chris@0: 
Chris@0:     sudo ./waf install
Chris@0: 
Chris@0: Configuration Options
Chris@0: ---------------------
Chris@0: 
Chris@0: All supported options can be viewed using the command:
Chris@0: 
Chris@0:     ./waf --help
Chris@0: 
Chris@0: Most options only need to be passed during the configure stage, for example:
Chris@0: 
Chris@0:     ./waf configure --prefix=/usr
Chris@0:     ./waf
Chris@0:     ./waf install
Chris@0: 
Chris@0: Compiler Configuration
Chris@0: ----------------------
Chris@0: 
Chris@0: Several standard environment variables can be used to control how compilers are
Chris@0: invoked:
Chris@0: 
Chris@0:  * CC:        Path to C compiler
Chris@0:  * CFLAGS:    C compiler options
Chris@0:  * CXX:       Path to C++ compiler
Chris@0:  * CXXFLAGS:  C++ compiler options
Chris@0:  * CPPFLAGS:  C preprocessor options
Chris@0:  * LINKFLAGS: Linker options
Chris@0: 
Chris@0: Installation Directories
Chris@0: ------------------------
Chris@0: 
Chris@0: The --prefix option (or the PREFIX environment variable) can be used to change
Chris@0: the prefix which all files are installed under.  There are also several options
Chris@0: allowing for more fine-tuned control, see the --help output for details.
Chris@0: 
Chris@0: Packaging
Chris@0: ---------
Chris@0: 
Chris@0: Everything can be installed to a specific root directory by passing a --destdir
Chris@0: option to the install stage (or setting the DESTDIR environment variable),
Chris@0: which adds a prefix to all install paths.  For example:
Chris@0: 
Chris@0:     ./waf configure --prefix=/usr
Chris@0:     ./waf
Chris@0:     ./waf install --destdir=/tmp/package