summaryrefslogtreecommitdiffstats
path: root/INSTALL.md
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2022-08-22 10:59:40 -0400
committerDavid Robillard <d@drobilla.net>2022-08-22 10:59:40 -0400
commitf543e4e791326c1b11380eab3574331d0647fc35 (patch)
tree0f1d5f1f4e8be7ea002330511a86b75cea06ef6f /INSTALL.md
parente1c2053ff1814d5f0f2fc30e7e9f150f7032f500 (diff)
downloadganv-f543e4e791326c1b11380eab3574331d0647fc35.tar.gz
ganv-f543e4e791326c1b11380eab3574331d0647fc35.tar.bz2
ganv-f543e4e791326c1b11380eab3574331d0647fc35.zip
Update INSTALL.md for meson
Diffstat (limited to 'INSTALL.md')
-rw-r--r--INSTALL.md59
1 files changed, 59 insertions, 0 deletions
diff --git a/INSTALL.md b/INSTALL.md
new file mode 100644
index 0000000..623cddd
--- /dev/null
+++ b/INSTALL.md
@@ -0,0 +1,59 @@
+Installation Instructions
+=========================
+
+Basic Installation
+------------------
+
+Building this software requires only Python. To install with default options:
+
+ ./waf configure
+ ./waf
+ ./waf install
+
+You may need to become root for the install stage, for example:
+
+ sudo ./waf install
+
+Configuration Options
+---------------------
+
+All supported options can be viewed using the command:
+
+ ./waf --help
+
+Most options only need to be passed during the configure stage, for example:
+
+ ./waf configure --prefix=/usr
+ ./waf
+ ./waf install
+
+Compiler Configuration
+----------------------
+
+Several standard environment variables can be used to control how compilers are
+invoked:
+
+ * 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
+------------------------
+
+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
+---------
+
+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