gnulib.texi (Library version handling): Add ELF symbol collision

workaround, suggested by Bruno.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 724039d173247ae8d0b9f96b1e1487228424690f..e4b32e36e85bca85dc3adb6ae60ede4722490718 100644 (file)
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2005-07-16  Simon Josefsson  <jas@extundo.com>
+
+       * gnulib.texi (Library version handling): Add ELF symbol collision
+       workaround, suggested by Bruno.
+
 2005-07-11  Karl Berry  <karl@gnu.org>
 
        * gnulib.texi (Quoting): new node.

diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index 8f6a41fda32111529ae5edf1450dbaf3967051c5..8e434a24f167cae88c07fd6427b3e600db490b8c 100644 (file)
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -1,5 +1,5 @@
 \input texinfo   @c -*-texinfo-*-
-@comment $Id: gnulib.texi,v 1.12 2005-07-11 16:45:26 haible Exp $
+@comment $Id: gnulib.texi,v 1.13 2005-07-16 19:41:33 jas Exp $
 @comment %**start of header
 @setfilename gnulib.info
 @settitle GNU Gnulib
@@ -7,7 +7,7 @@
 @syncodeindex pg cp
 @comment %**end of header
 
-@set UPDATED $Date: 2005-07-11 16:45:26 $
+@set UPDATED $Date: 2005-07-16 19:41:33 $
 
 @copying
 This manual is for GNU Gnulib (updated @value{UPDATED}),
@@ -295,7 +295,7 @@ fail.
 @node Library version handling
 @section Library version handling
 
-The module ``check_version'' can be useful when your gnulib
+The module @samp{check-version} can be useful when your gnulib
 application is a system library.  You will typically wrap the call to
 the @code{check_version} function through a library API, your library
 header file may contain:
@@ -306,8 +306,16 @@ header file may contain:
   extern const char *stringprep_check_version (const char *req_version);
 @end example
 
-The implementation of @code{stringprep_check_version} would simply
-pass on the call to @code{check_version}.
+To avoid ELF symbol collisions with other libraries that use the
+@samp{check-version} module, add to @file{config.h} through a
+AC_DEFINE something like:
+
+@example
+AC_DEFINE(check_version, stringprep_check_version, [Rename check_version.])
+@end example
+
+The @code{stringprep_check_version} function will thus be implemented
+by the @code{check_version} module.
 
 There are two uses of the interface.  The first is a way to provide
 for applications to find out the version number of the library it