From 87f8ee6820822f6160a0430f9c099af4d782acdb Mon Sep 17 00:00:00 2001 From: David Robillard Date: Mon, 10 Oct 2011 02:31:08 +0000 Subject: Update documentation to remove lv2config references and describe correct include style. --- core.lv2/README | 26 +++++++++++++++++--------- 1 file changed, 17 insertions(+), 9 deletions(-) (limited to 'core.lv2/README') diff --git a/core.lv2/README b/core.lv2/README index 4e570f7..845bf40 100644 --- a/core.lv2/README +++ b/core.lv2/README @@ -10,17 +10,25 @@ designed so that extensions can be defined to add more advanced features. More information about LV2 can be found at . -Applications that use LV2 plugins should depend on this package. It includes a -header, pkg-config file, and lv2config (a header installation utility required -to compile against LV2 core and/or extensions). To compile against LV2, build -scripts can check for the pkg-config package "lv2core", or simply check for the -header "lv2/lv2plug.in/ns/lv2core/lv2.h". +Applications that use LV2 plugins should depend on this package. It includes a +header, LV2 bundle, and a pkg-config file. To compile against LV2, build +scripts should check for the pkg-config package "lv2core", or simply check for +the header "lv2/lv2plug.in/ns/lv2core/lv2.h". + +The appropriate C include for LV2 specifications is based on their URI, e.g.: + +#include "lv2/lv2plug.in/ns/lv2core/lv2.h" + +Is how code should include the header "lv2.h" in this bundle, which defines the +specification with URI "http://lv2plug.in/ns/lv2core". Other specifications +should follow this convention, e.g. the correct way to include the header +"foo.h" in the extension "http://example.org/foo" is: + +#include "lv2/example.org/foo/foo.h" Please package these components in a single package (e.g. do not split the -headers, data, and program into separate packages). This package, in its +headers, data, and program into separate packages). This package, in its entirety, is a build and run time dependency of any code that uses LV2. -Distributions are encouraged to include it with package name "lv2core". Note -that lv2config must be run after installation of any LV2 specifications, -including this one. +Distributions are encouraged to include it with package name "lv2core". -- David Robillard -- cgit v1.2.1