[ovs-git] [openvswitch/ovs] f12e09: libopenvswitch: Rename to libfoo-X.Y.

[GitHub]

  Branch: refs/heads/master
  Home:   https://github.com/openvswitch/ovs
  Commit: f12e09b7b2e50ba8df7aad6fc1d78b87c9a346c6
      https://github.com/openvswitch/ovs/commit/f12e09b7b2e50ba8df7aad6fc1d78b87c9a346c6
  Author: Joe Stringer <joe at ovn.org>
  Date:   2017-05-17 (Wed, 17 May 2017)

  Changed paths:
    M Documentation/internals/contributing/libopenvswitch-abi.rst
    M m4/openvswitch.m4

  Log Message:
  -----------
  libopenvswitch: Rename to libfoo-X.Y.

The current intent for Open vSwitch is to maintain libopenvswitch ABI
stability for minor versions, for example each release within the 2.7.z
series. According to the following documentation, no changes to exported
headers should be made.

http://docs.openvswitch.org/en/latest/internals/contributing/libopenvswitch-abi/

However, it is occasionally necessary to make changes to
{include/openvswitch,lib}/*.h headers to fix issues within a given
release series. The current libtool tagging mechanism in the build
system does not allow for this without creating a conflict between the
libtool 'current' version and the next minor release of OVS.

This patch modifies libopenvswitch build to include the MAJOR.MINOR
release version in the libX name, and include the libtool CURRENT and
OVS MICRO release in the libtool versioning tags to indicate library
stability. The resulting format is "libfoo-X.Y.so.CURRENT.0.Z" for OVS
release "X.Y.Z".

Developers should still attempt to avoid introducing ABI-breaking changes
within a particular OVS-X.Y release series, but if this is not possible
this patch introduced a mechanism to allow an ABI-breaking fix to be
introduced. In such a case, developers may update the libtool CURRENT
version to indicate this breakage to library users.

Signed-off-by: Joe Stringer <joe at ovn.org>
Acked-by: Ben Pfaff <blp at ovn.org>


  Commit: bf824a02ec9c15bae2d82da1070ee59f6eeca886
      https://github.com/openvswitch/ovs/commit/bf824a02ec9c15bae2d82da1070ee59f6eeca886
  Author: Joe Stringer <joe at ovn.org>
  Date:   2017-05-17 (Wed, 17 May 2017)

  Changed paths:
    M configure.ac

  Log Message:
  -----------
  configure: Reset libtool CURRENT version.

Since commit f12e09b7b2e5 ("libopenvswitch: Rename to libfoo-X.Y."), the
CURRENT libtool number is no longer derived from the OVS MINOR (from
vMAJOR.MINOR.MICRO) version, so it can be reset to 0.

Developers should attempt to avoid introducing ABI-breaking changes
within a particular OVS-X.Y release series. Occasionally due to the
nature of a particular bug, this is not possible. In such a case,
developers must update the libtool CURRENT version to indicate this
breakage to library users.

In most OVS library releases, this is expected to remain 0.

Signed-off-by: Joe Stringer <joe at ovn.org>
Acked-by: Ben Pfaff <blp at ovn.org>


Compare: https://github.com/openvswitch/ovs/compare/621268a6143a...bf824a02ec9c