summaryrefslogtreecommitdiffstats
path: root/INSTALL
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2015-10-08 19:38:29 +0000
committerDavid Robillard <d@drobilla.net>2015-10-08 19:38:29 +0000
commit06e594bbe6d977659670fcaef776b6d59d5c4992 (patch)
treee204f6e5165cd89554604334a610c72964443e5c /INSTALL
parent2849229ebfb818fb867cd2fb327a8fb66be30723 (diff)
downloadlilv-06e594bbe6d977659670fcaef776b6d59d5c4992.tar.gz
lilv-06e594bbe6d977659670fcaef776b6d59d5c4992.tar.bz2
lilv-06e594bbe6d977659670fcaef776b6d59d5c4992.zip
Update INSTALL file
git-svn-id: http://svn.drobilla.net/lad/trunk/lilv@5751 a436a847-0d15-0410-975c-d299462d15a1
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL27
1 files changed, 17 insertions, 10 deletions
diff --git a/INSTALL b/INSTALL
index 623cddd..9b54f51 100644
--- a/INSTALL
+++ b/INSTALL
@@ -8,11 +8,7 @@ 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
+ ./waf install # or sudo ./waf install
Configuration Options
---------------------
@@ -40,12 +36,20 @@ invoked:
* CPPFLAGS: C preprocessor options
* LINKFLAGS: Linker options
-Installation Directories
-------------------------
+Library Versioning
+------------------
+
+This library uses semantic versioning <http://semver.org/>.
+
+Several major versions can be installed in parallel. The shared library name,
+include directory, and pkg-config file are suffixed with the major version
+number. For example, a library named "foo" at version 1.x.y might install:
-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.
+ /usr/include/foo-1/foo/foo.h
+ /usr/lib/foo-1.so.1.x.y
+ /usr/lib/pkgconfig/foo-1.pc
+
+Dependencies can check for the package "foo-1" with pkg-config.
Packaging
---------
@@ -57,3 +61,6 @@ which adds a prefix to all install paths. For example:
./waf configure --prefix=/usr
./waf
./waf install --destdir=/tmp/package
+
+Packages should allow parallel installation of several major versions. For
+example, the above would be packaged as "foo-1". \ No newline at end of file