annotate src/serd-0.18.2/PACKAGING @ 169:223a55898ab9 tip default

Add null config files
author Chris Cannam <cannam@all-day-breakfast.com>
date Mon, 02 Mar 2020 14:03:47 +0000
parents 545efbb81310
children
rev   line source
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.