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
commit3cd833e602aeffafab685c1e2a1829d7901222f9 (patch)
parent8c18270029d71b229a7384f75a22caacb5269301 (diff)
Improve INSTALL file.
git-svn-id: http://svn.drobilla.net/lad/trunk/plugins/mda.lv2@4523 a436a847-0d15-0410-975c-d299462d15a1
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