summaryrefslogtreecommitdiffstats
path: root/PACKAGING
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2011-05-24 19:21:49 +0000
committerDavid Robillard <d@drobilla.net>2011-05-24 19:21:49 +0000
commite093312a225c5252632ebb5d15b71fd19648b366 (patch)
tree3d69fc5ec3720aef6ae5b6636e751686f1fc27e2 /PACKAGING
parent6dd5b9a2a403347dccdfaa769427fd7ca4955695 (diff)
downloadsord-e093312a225c5252632ebb5d15b71fd19648b366.tar.gz
sord-e093312a225c5252632ebb5d15b71fd19648b366.tar.bz2
sord-e093312a225c5252632ebb5d15b71fd19648b366.zip
Add PACKAGING file
git-svn-id: http://svn.drobilla.net/sord/trunk@133 3d64ff67-21c5-427c-a301-fe4f08042e5a
Diffstat (limited to 'PACKAGING')
-rw-r--r--PACKAGING29
1 files changed, 29 insertions, 0 deletions
diff --git a/PACKAGING b/PACKAGING
new file mode 100644
index 0000000..3eced16
--- /dev/null
+++ b/PACKAGING
@@ -0,0 +1,29 @@
+This library is designed to allow parallel installation of different major
+versions. To facilitate this, the shared library name, include directory, and
+pkg-config file are suffixed with the major version number of the library.
+
+For example, if this library was named "foo" and at version 1.x.y:
+
+/usr/include/foo-1/foo/foo.h
+/usr/lib/foo-1.so.1.x.y
+/usr/lib/pkgconfig/foo-1.pc
+
+Dependencies check for pkg-config name "foo-1" and will build
+against a compatible version 1, regardless any other installed versions.
+
+*** IMPORTANT GUIDELINES FOR PACKAGERS ***
+
+Packages should follow the same conventions as above, i.e. include the major
+version (and only the major version) in the name of the package. Continuing the
+example above, the package(s) would be named foo-1 and foo-1-dev. This way,
+if/when version 2 comes out, it may be installed at the same time as version 1
+without breaking anything.
+
+Please do not create packages of this library that do not follow these
+guidelines, you will break things and cause unnecessary headaches. Please do
+not use any number as a suffix other than the actual major version number of the
+upstream source package.
+
+Because program and documentation names are not versioned, these should be
+included in separate packages which may replace previous versions, since
+there is little use in having parallel installations of them. \ No newline at end of file