summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.gitignore1
-rw-r--r--INSTALL59
2 files changed, 59 insertions, 1 deletions
diff --git a/.gitignore b/.gitignore
index 325b2059cd..ead1bd993e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -72,7 +72,6 @@ __pycache__
/compile
/test-driver
/missing
-/INSTALL
/ABOUT-NLS
/config.rpath
/coverage
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 0000000000..2eac4a6af4
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,59 @@
+** COMPILING and INSTALLING **
+------------------------------
+
+Meson is the build system used for this project. For more information please
+see:
+
+ http://mesonbuild.com
+
+----
+
+Normal compilation in /usr/local:
+
+ meson . build
+ ninja -C build
+ sudo ninja -C build install
+
+For meson build generic options:
+
+ meson --help
+
+For a list of project specific options supported:
+
+ cat meson_options.txt
+
+To set 1 or more project specific options:
+
+ meson --prefix=/path/to -Doption=value [-Dother=value2] [...] . build
+
+To display current configuration:
+
+ meson configure build
+
+The above will only work after at least the following is done:
+
+ meson . build
+
+** QUICK AND DIRTY HELP **
+--------------------------
+
+How clean out the build and config and start fresh:
+
+ rm -rf build
+
+How to make a dist tarball and check its build:
+(must do it from git tree clone and commit all changes to git first)
+
+ ninja -C build dist
+
+How to change prefix:
+
+ meson --prefix=/path/to/prefix . build
+
+How to install in a specific destination directory for packaging:
+
+ DESTDIR=/path/to/destdir ninja -C build install
+
+How to build with verbose output (full commands run):
+
+ ninja -C build -v