From c0961e6a827a8abcf1532a7671f09048e390648c Mon Sep 17 00:00:00 2001
From: Carl Worth <cworth@cworth.org>
Date: Thu, 1 Apr 2010 00:41:25 -0700
Subject: [PATCH] lib: Switch to a 3-part version number for the library
 interface.

With a carefully documented description of how to increment the
various version components.
---
 Makefile.local     |  2 +-
 lib/Makefile.local | 35 ++++++++++++++++++++++++++++-------
 2 files changed, 29 insertions(+), 8 deletions(-)

diff --git a/Makefile.local b/Makefile.local
index 9b7423ed..32b8f4a8 100644
--- a/Makefile.local
+++ b/Makefile.local
@@ -107,7 +107,7 @@ notmuch_client_srcs =		\
 
 notmuch_client_modules = $(notmuch_client_srcs:.c=.o)
 notmuch: $(notmuch_client_modules) lib/libnotmuch.so
-	$(call quiet,CC,$(LDFLAGS)) -Llib -lnotmuch $(filter-out lib/libnotmuch.so,$^) $(FINAL_LDFLAGS) -o $@
+	$(call quiet,CC,$(LDFLAGS)) -Llib -lnotmuch $(notmuch_client_modules) $(FINAL_LDFLAGS) -o $@
 
 notmuch.1.gz: notmuch.1
 	$(call quiet,gzip) --stdout $^ > $@
diff --git a/lib/Makefile.local b/lib/Makefile.local
index 0463c93a..0fd843a1 100644
--- a/lib/Makefile.local
+++ b/lib/Makefile.local
@@ -1,4 +1,21 @@
-SONAME = libnotmuch.so.1
+# The major version of the library interface. This will control the soname.
+# As such, this number must be incremented for any incompatible change to
+# the library interface, (such as the deletion of an API or a major
+# semantic change that breaks formerly functioning code).
+LIBNOTMUCH_VERSION_MAJOR = 1
+
+# The minor version of the library interface. This should be incremented at
+# the time of release for any additions to the library interface.
+LIBNOTMUCH_VERSION_MINOR = 0
+
+# The release version the library interface. This should be incremented at
+# the time of release if there have been no changes to the interface, (but
+# simply compatible changes to the implementation).
+LIBNOTMUCH_VERSION_RELEASE = 0
+
+LINKER_NAME = libnotmuch.so
+SONAME = $(LINKER_NAME).$(LIBNOTMUCH_VERSION_MAJOR)
+LIBNAME = $(SONAME).$(LIBNOTMUCH_VERSION_MINOR).$(LIBNOTMUCH_VERSION_RELEASE)
 
 dir := lib
 extra_cflags += -I$(dir) -fPIC
@@ -21,19 +38,23 @@ libnotmuch_cxx_srcs =		\
 
 libnotmuch_modules = $(libnotmuch_c_srcs:.c=.o) $(libnotmuch_cxx_srcs:.cc=.o)
 
-$(dir)/$(SONAME) : $(libnotmuch_modules)
+$(dir)/$(LIBNAME) : $(libnotmuch_modules)
 	$(call quiet,CXX,$(LDFLAGS)) $^ $(FINAL_LDFLAGS) -shared -Wl,-soname=$(SONAME) -o $@
 
-$(dir)/libnotmuch.so: $(dir)/$(SONAME)
-	$(call quiet_symlink, $(SONAME) $@)
+$(dir)/$(SONAME): $(dir)/$(LIBNAME)
+	$(call quiet_symlink, $(LIBNAME) $@)
+
+$(dir)/$(LINKER_NAME): $(dir)/$(SONAME)
+	$(call quiet_symlink, $(LIBNAME) $@)
 
 install: install-$(dir)
 
 install-$(dir):
 	$(call quiet_mkdir, $(DESTDIR)$(libdir)/)
-	$(call quiet_install_data, $(dir)/$(SONAME) $(DESTDIR)$(libdir)/)
+	$(call quiet_install_data, $(dir)/$(LIBNAME) $(DESTDIR)$(libdir)/)
+	$(call quiet_symlink, $(LIBNAME) $(DESTDIR)$(libdir)/$(SONAME))
+	$(call quiet_symlink, $(LIBNAME) $(DESTDIR)$(libdir)/$(LINKER_NAME))
 	$(call quiet_install_data, $(dir)/notmuch.h $(DESTDIR)$(prefix)/include/)
-	$(call quiet_symlink, $(SONAME) $(DESTDIR)$(libdir)/libnotmuch.so)
 
 SRCS  := $(SRCS) $(libnotmuch_c_srcs) $(libnotmuch_cxx_srcs)
-CLEAN := $(CLEAN) $(libnotmuch_modules) $(dir)/$(SONAME) $(dir)/libnotmuch.so *.so
+CLEAN := $(CLEAN) $(libnotmuch_modules) $(dir)/$(SONAME) $(dir)/$(LINKER_NAME) $(dir)$(LIBNAME)
-- 
2.26.2