cannam@85
|
1 This library is designed to allow parallel installation of different major
|
cannam@85
|
2 versions. To facilitate this, the shared library name, include directory, and
|
cannam@85
|
3 pkg-config file are suffixed with the major version number of the library.
|
cannam@85
|
4
|
cannam@85
|
5 For example, if this library was named "foo" and at version 1.x.y:
|
cannam@85
|
6
|
cannam@85
|
7 /usr/include/foo-1/foo/foo.h
|
cannam@85
|
8 /usr/lib/foo-1.so.1.x.y
|
cannam@85
|
9 /usr/lib/pkgconfig/foo-1.pc
|
cannam@85
|
10
|
cannam@85
|
11 Dependencies check for pkg-config name "foo-1" and will build
|
cannam@85
|
12 against a compatible version 1, regardless any other installed versions.
|
cannam@85
|
13
|
cannam@85
|
14 *** IMPORTANT GUIDELINES FOR PACKAGERS ***
|
cannam@85
|
15
|
cannam@85
|
16 Packages should follow the same conventions as above, i.e. include the major
|
cannam@85
|
17 version (and only the major version) in the name of the package. Continuing the
|
cannam@85
|
18 example above, the package(s) would be named foo-1 and foo-1-dev. This way,
|
cannam@85
|
19 if/when version 2 comes out, it may be installed at the same time as version 1
|
cannam@85
|
20 without breaking anything.
|
cannam@85
|
21
|
cannam@85
|
22 Please do not create packages of this library that do not follow these
|
cannam@85
|
23 guidelines, you will break things and cause unnecessary headaches. Please do
|
cannam@85
|
24 not use any number as a suffix other than the actual major version number of the
|
cannam@85
|
25 upstream source package.
|
cannam@85
|
26
|
cannam@85
|
27 Because program and documentation names are not versioned, these should be
|
cannam@85
|
28 included in separate packages which may replace previous versions, since
|
cannam@85
|
29 there is little use in having parallel installations of them. |