diff options
| author | Carl Worth <cworth@cworth.org> | 2010-04-01 00:41:25 -0700 |
|---|---|---|
| committer | Carl Worth <cworth@cworth.org> | 2010-04-01 00:41:25 -0700 |
| commit | c0961e6a827a8abcf1532a7671f09048e390648c (patch) | |
| tree | cb01aeff7a8c549a398e90fbfcd74f9660d9025e | |
| parent | c20be126e5e52af9b8cdff5685124e4a867e375a (diff) | |
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.
| -rw-r--r-- | Makefile.local | 2 | ||||
| -rw-r--r-- | lib/Makefile.local | 35 |
2 files changed, 29 insertions, 8 deletions
diff --git a/Makefile.local b/Makefile.local index 9b7423e..32b8f4a 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 0463c93..0fd843a 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) |