aboutsummaryrefslogtreecommitdiffstats
path: root/core.lv2/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'core.lv2/INSTALL')
-rw-r--r--core.lv2/INSTALL58
1 files changed, 25 insertions, 33 deletions
diff --git a/core.lv2/INSTALL b/core.lv2/INSTALL
index da0ae59..6eeb454 100644
--- a/core.lv2/INSTALL
+++ b/core.lv2/INSTALL
@@ -1,52 +1,44 @@
This software requires only Python to build.
-= LV2 Core package instructions =
+= LV2Core =
-This package contains a header file, pkg-config file, and an LV2 bundle;
-there is no code that requires compiling (i.e. this is NOT a library).
-Accordingly, the versioning scheme is simpler than a library: the major
-number is the version number of the LV2 specification, and the minor
-number is the version of this package. There is no 'micro' number.
+This package contains everything necessary to compile against and/or use LV2
+plugins and extensions: a header file, pkg-config file, LV2 bundle (with Turtle
+files), and a utility program (lv2config).
-The configure option --bundle-only can be used to install only the bundle.
-This can be used in conjunction with the --lv2-user option to install
-only the bundle to the user-specific (i.e. in your home directory) LV2
-path, if you do not have write access to the system.
+The configure option --bundle-only can be used to install only the bundle. This
+is useful for installing the bundle to a user-specific location (e.g. ~/.lv2).
-Distribution packages should install everything, as apps may depend
-on 'lv2core' (via pkg-config) to ensure both the header and data
-bundle are present.
+Any C header(s) are a part of the bundle. Packages must not separate the
+header(s) into a separate package from the bundle, as this would break
+lv2config. The utility lv2config builds standard LV2 style include directory
+trees, and is necessary for compiling LV2 code. Programs can use pkg-config to
+check for package 'lv2core' to ensure all this data (bundle, including any
+contained header(s), and lv2config) is available on the system. Programs may
+also simply check for the header "lv2/lv2plug.in/ns/lv2core/lv2.h".
-= Generic waf instructions =
+= Generic Waf Instructions =
-Like an auto* project, building has three phases:
+As with most build systems, building and installing a project with waf is done
+in three separate stages:
-
-* Configure: ./waf configure [OPTIONS]
-
- Example:
- ./waf configure --prefix=/some/where
+Configure: ./waf configure [OPTIONS]
+ e.g.: ./waf configure --prefix=/some/where
The default prefix is /usr/local
-* Build: ./waf [OPTIONS]
+Build: ./waf [OPTIONS]
+ e.g.: ./waf
- Example:
- ./waf
-
-* Install: ./waf install [OPTIONS]
+Install: ./waf install [OPTIONS]
+ e.g.: ./waf install
+ e.g.: DESTDIR=/home/drobilla/packages ./waf install
The environment variable DESTDIR can be used to add any prefix to
- the install paths (useful for packaging). Example:
-
- DESTDIR=/home/drobilla/packages ./waf install
-
-
-*** IMPORTANT: You must use absolute paths everywhere
-
+ the install paths (useful for packaging).
+
Run './waf --help' for detailed option information.
-