Update libtirpc.so library version information

Bump the library version information for libtirpc to match the latest
version distributed by Red Hat (libtirpc.so.1.0.10).  Without this
change, the latest git repo installs libtirpc.so.1.0.9.

Add an annoying block comment in the Makefile describing how to keep
the library version up to date, 'cause it's kind of confusing, and
apparently entirely unrelated to the package and release version.

Before each release of upstream libtirpc, these version information
rules should be revisited.

Signed-off-by: Chuck Lever <chuck.lever@oracle.com>
Signed-off-by: Steve Dickson <steved@redhat.com>

diff --git a/src/Makefile.am b/src/Makefile.am
index a76c37777222ce7dc72c3dcc41c17fb33cd01b60..f832baa8464264415ac7b2cd0e09107bae40a2c7 100644 (file)
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -11,7 +11,36 @@ INCLUDES = -I../tirpc -DPORTMAP -DINET6 -DVERSION="\"$(VERSION)\"" \
 
 lib_LTLIBRARIES = libtirpc.la
 
-libtirpc_la_LDFLAGS = -lnsl -lpthread -version-info 1:9:0
+#
+# Set the library version information
+#
+# According to the libtool manual:
+#
+# "This flag accepts an argument of the form current[:revision[:age]].
+#
+# If either revision or age are omitted, they default to 0. Also note that
+# age must be less than or equal to the current interface number.
+#
+# Here are a set of rules to help you update your library version information:
+#
+# 1.  Start with version information of 0:0:0 for each libtool library.
+# 2.  Update the version information only immediately before a public
+#     release of your software. More frequent updates are unnecessary,
+#     and only guarantee that the current interface number gets larger faster.
+# 3.  If the library source code has changed at all since the last update,
+#     then increment revision (c:r:a becomes c:r+1:a).
+# 4.  If any interfaces have been added, removed, or changed since the last
+#     update, increment current, and set revision to 0.
+# 5.  If any interfaces have been added since the last public release,
+#     then increment age.
+# 6.  If any interfaces have been removed since the last public release,
+#     then set age to 0.
+#
+# _Never_ try to set the interface numbers so that they correspond to the
+# release number of your package. This is an abuse that only fosters
+# misunderstanding of the purpose of library versions."
+#
+libtirpc_la_LDFLAGS = -lnsl -lpthread -version-info 1:10:0
 
 libtirpc_la_SOURCES = auth_none.c auth_unix.c authunix_prot.c bindresvport.c clnt_bcast.c \
         clnt_dg.c clnt_generic.c clnt_perror.c clnt_raw.c clnt_simple.c \