[Spice-devel] [PATCH v2 1/2] configure.ac: highlight current, revision and age

[Alon Levy]

Move to the top so anyone changing the library version will have a
higher likelihood of noticing them and thinking if they need changes as
well. Added the rules, copied from libtool's info page, as a reminder.

Added some obvious docs for the already defined SPICE_MICRO, SPICE_MINOR
and SPICE_MAJOR.
---
 configure.ac |   36 +++++++++++++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/configure.ac b/configure.ac
index 66f9d12..abe9092 100644
--- a/configure.ac
+++ b/configure.ac
@@ -1,8 +1,42 @@
 AC_PREREQ([2.57])
 
+# Making releases:
+# Increment SPICE_MICRO if no interface change has been done
+# Increment SPICE_MINOR and zero SPICE_MICRO if new backward compatible
+# interfaces have been added.
+# Increment SPICE_MAJOR and zero both SPICE_MINOR and SPICE_MICRO if non
+# backward compatible changes (interface changed or removed).
+#
+# *additionally* follow the rules below for the libtool version.
+
 m4_define([SPICE_MAJOR], 0)
 m4_define([SPICE_MINOR], 10)
 m4_define([SPICE_MICRO], 1)
+# See info libtool or http://www.gnu.org/software/libtool/manual/html_node/Updating-version-info.html
+# Here are the 6 rules: (rule 1 here just to avoid saying what I omitted)
+
+# 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 or changed since the last
+#    public release, then set AGE to 0.
+
+m4_define([SPICE_CURRENT], [1])
+m4_define([SPICE_REVISION], [0])
+m4_define([SPICE_AGE], [2])
 
 AC_INIT(spice, [SPICE_MAJOR.SPICE_MINOR.SPICE_MICRO], [], spice)
 
@@ -33,7 +67,7 @@ AC_FUNC_ALLOCA
 
 AC_DEFINE([__STDC_FORMAT_MACROS],[],[Force definition of format macros for C++])
 
-SPICE_LT_VERSION=m4_format("%d:%d:%d", 1, 0, 2)
+SPICE_LT_VERSION=m4_format("%d:%d:%d", SPICE_CURRENT, SPICE_REVISION, SPICE_AGE)
 AC_SUBST(SPICE_LT_VERSION)
 
 # Check for the CPU we are using
-- 
1.7.10.1