diff options
| author | David Robillard <d@drobilla.net> | 2012-07-09 03:44:34 +0000 |
|---|---|---|
| committer | David Robillard <d@drobilla.net> | 2012-07-09 03:44:34 +0000 |
| commit | 9963ff5c16b3c5afe47d209df5cffde10c6523a8 (patch) | |
| tree | 6695a2449077a422198787b828bce522b2328c0f | |
| parent | cfdaaada78986aedb9b61c77620dc39e78418032 (diff) | |
| download | machina-9963ff5c16b3c5afe47d209df5cffde10c6523a8.tar.gz machina-9963ff5c16b3c5afe47d209df5cffde10c6523a8.tar.bz2 machina-9963ff5c16b3c5afe47d209df5cffde10c6523a8.zip | |
Improve INSTALL file.
git-svn-id: http://svn.drobilla.net/lad/trunk/machina@4523 a436a847-0d15-0410-975c-d299462d15a1
| -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 |