diff options
| author | David Robillard <d@drobilla.net> | 2012-07-09 08:13:13 +0000 |
|---|---|---|
| committer | David Robillard <d@drobilla.net> | 2012-07-09 08:13:13 +0000 |
| commit | 4ec88b5ad2eef7fe23929c95adfc3b7466d4881f (patch) | |
| tree | 5884ae0aa4b9901a21ad0f7e271fd92aef2f1787 /INSTALL | |
| parent | e7a4fd12b13c65b6e44dbd8e20f3aae43e3ca90b (diff) | |
| download | serd-4ec88b5ad2eef7fe23929c95adfc3b7466d4881f.tar.gz serd-4ec88b5ad2eef7fe23929c95adfc3b7466d4881f.tar.bz2 serd-4ec88b5ad2eef7fe23929c95adfc3b7466d4881f.zip | |
Improve INSTALL file.
git-svn-id: http://svn.drobilla.net/serd/trunk@357 490d8e77-9747-427b-9fa3-0b8f29cee8a0
Diffstat (limited to 'INSTALL')
| -rw-r--r-- | INSTALL | 58 |
1 files changed, 41 insertions, 17 deletions
@@ -1,35 +1,59 @@ -This software requires only Python to build. +Installation Instructions +========================= -Like an auto* project, building has three phases: +Basic Installation +------------------ +Building this software requires only Python. To install with default options: -* Configure: ./waf configure [OPTIONS] + ./waf configure + ./waf + ./waf install - Example: - ./waf configure --prefix=/some/where --debug --strict +You may need to become root for the install stage, for example: - If --debug is not given, the flags from the environment variables - CFLAGS and CXXFLAGS will be used. + sudo ./waf install - The default prefix is /usr/local +Configuration Options +--------------------- +All supported options can be viewed using the command: -* Build: ./waf [OPTIONS] + ./waf --help - Example: - ./waf -j4 +Most options only need to be passed during the configure stage, for example: + ./waf configure --prefix=/usr + ./waf + ./waf install -* Install: ./waf install [OPTIONS] +Compiler Configuration +---------------------- - The environment variable DESTDIR can be used to add any prefix to - the install paths (useful for packaging). Example: +Several standard environment variables can be used to control how compilers are +invoked: - DESTDIR=/home/drobilla/packages ./waf install + * CC: Path to C compiler + * CFLAGS: C compiler options + * CXX: Path to C++ compiler + * CXXFLAGS: C++ compiler options + * CPPFLAGS: C preprocessor options + * LINKFLAGS: Linker options +Installation Directories +------------------------ -*** IMPORTANT: You must use absolute paths everywhere +The --prefix option (or the PREFIX environment variable) can be used to change +the prefix which all files are installed under. There are also several options +allowing for more fine-tuned control, see the --help output for details. +Packaging +--------- -Run './waf --help' for detailed option information. +Everything can be installed to a specific root directory by passing a --destdir +option to the install stage (or setting the DESTDIR environment variable), +which adds a prefix to all install paths. For example: + ./waf configure --prefix=/usr + ./waf + ./waf install --destdir=/tmp/package |