[SCM] GNU Libtool branch, master, updated. v2.2.6-153-g7890173

[Ralf Wildenhues]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU Libtool".

The branch, master has been updated
       via  7890173078d185548f1f058322d8ddc3b18cfc81 (commit)
      from  a4cc3d2c9f4190a0425d03f57bb38bfb4a0ea1b7 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 7890173078d185548f1f058322d8ddc3b18cfc81
Author: Ralf Wildenhues <address@hidden>
Date:   Sun Nov 1 11:38:23 2009 +0100

    Improve versioning algorithm documentation.
    
    * doc/libtool.texi (Updating version info): Repeat the
    algorithms in different, hopefully simpler terms.
    * THANKS: Update.
    Prompted by Richard B. Kreckel.
    
    Signed-off-by: Ralf Wildenhues <address@hidden>

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog        |    8 ++++++++
 THANKS           |    1 +
 doc/libtool.texi |   31 +++++++++++++++++++++++++++++++
 3 files changed, 40 insertions(+), 0 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 496911b..61bc746 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2009-11-01  Ralf Wildenhues  <address@hidden>
+
+       Improve versioning algorithm documentation.
+       * doc/libtool.texi (Updating version info): Repeat the
+       algorithms in different, hopefully simpler terms.
+       * THANKS: Update.
+       Prompted by Richard B. Kreckel.
+
 2009-11-01  Ingo Weinhold  <address@hidden>  (tiny change)
 
        Support for the Haiku operating system.
diff --git a/THANKS b/THANKS
index 03cd592..691017d 100644
--- a/THANKS
+++ b/THANKS
@@ -145,6 +145,7 @@
   Rainer Orth                  address@hidden
   Rainer Tammer                        address@hidden
   Ralf Menzel                  address@hidden
+  Richard B. Kreckel           address@hidden
   Richard Purdie               address@hidden
   Richard Sandiford            address@hidden
   Robert Garron                        address@hidden
diff --git a/doc/libtool.texi b/doc/libtool.texi
index 27bf221..482e635 100644
--- a/doc/libtool.texi
+++ b/doc/libtool.texi
@@ -2870,6 +2870,37 @@ Instead, use the @option{-release} flag (@pxref{Release 
numbers}), but be
 warned that every release of your package will not be binary compatible
 with any other release.
 
+The following explanation may help to understand the above rules a bit
+better: consider that there are three possible kinds of reactions from
+users of your library to changes in a shared library:
+
address@hidden 1
address@hidden
+Programs using the previous version may use the new version as
+drop-in replacement, and programs using the new version can also work
+with the previous one.  In other words, no recompiling nor relinking
+is needed.  In this case, bump @var{revision} only, don't touch
address@hidden nor @var{age}.
+
address@hidden
+Programs using the previous version may use the new version as
+drop-in replacement, but programs using the new version may use APIs not
+present in the previous one.  In other words, a program linking against
+the new version may fail with ``unresolved symbols'' if linking against
+the old version at runtime: set @var{revision} to 0, bump @var{current}
+and @var{age}.
+
address@hidden
+Programs may need to be changed, recompiled, relinked in order to use
+the new version.  Bump @var{current}, set @var{revision} and @var{age}
+to 0.
address@hidden enumerate
+
address@hidden
+In the above description, @emph{programs} using the library in question
+may also be replaced by other libraries using it.
+
+
 @node Release numbers
 @section Managing release information
 


hooks/post-receive
-- 
GNU Libtool