path: root/INSTALL
diff options
authorDavid Robillard <d@drobilla.net>2012-07-09 03:44:34 +0000
committerDavid Robillard <d@drobilla.net>2012-07-09 03:44:34 +0000
commitb50c346fbec29c14acdcac84309e910d782b47ca (patch)
tree2642e1778982be8b7bca6867addfd2ca8a95c2fb /INSTALL
parent57e9096c2fc6cc157694af777f857a63cf9dca3c (diff)
Improve INSTALL file.
git-svn-id: http://svn.drobilla.net/lad/trunk/jalv@4523 a436a847-0d15-0410-975c-d299462d15a1
Diffstat (limited to 'INSTALL')
1 files changed, 41 insertions, 17 deletions
diff --git a/INSTALL b/INSTALL
index f6e4dd4..623cddd 100644
@@ -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
- 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.
-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