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