FYI backport notes.texi from HEAD

[Peter O'Gorman]

I applied this to branch-1-5.

Peter
-- 
Peter O'Gorman
http://pogma.com

 2008-01-24  Peter O'Gorman  <address@hidden>
 
        * doc/libtool/texi: Backport notes.texi from HEAD.

Index: doc/libtool.texi
===================================================================
RCS file: /sources/libtool/libtool/doc/libtool.texi,v
retrieving revision 1.134.2.24
diff -u -r1.134.2.24 libtool.texi
--- doc/libtool.texi    30 Nov 2007 04:19:20 -0000      1.134.2.24
+++ doc/libtool.texi    24 Jan 2008 07:16:21 -0000
@@ -137,6 +137,7 @@
 Configuring libtool
 
 * AC_PROG_LIBTOOL::             Configuring @code{libtool} in 
@file{configure.in}.
+* Configure notes::             Platform-specific notes for configuration.
 
 Including libtool in your package
 
@@ -1632,6 +1633,7 @@
 
 @menu
 * AC_PROG_LIBTOOL::             Configuring @code{libtool} in 
@file{configure.in}.
+* Configure notes::             Platform-specific notes for configuration.
 @end menu
 
 @node AC_PROG_LIBTOOL
@@ -1840,6 +1842,91 @@
 @code{aclocal}.  This may lead to weird errors when versions don't
 match.
 
+
address@hidden Configure notes
address@hidden Platform-specific configuration notes
+
+While Libtool tries to hide as many platform-specific features as possible,
+some have to be taken into account when configuring either the Libtool package
+or a libtoolized package.
+
address@hidden
+
address@hidden
+On AIX there are two different styles of shared linking, one in which symbols
+are bound at link-time and one in which symbols are bound at runtime only,
+similar to address@hidden  In case of doubt use @code{LDFLAGS=-Wl,-brtl} for 
the latter style.
+
address@hidden
+On AIX, native tools are to be preferred over binutils; especially for C++ 
code,
+if using the AIX Toolbox GCC 4.0 and binutils, configure with
address@hidden/usr/bin/ar LD=/usr/bin/ld NM='/usr/bin/nm -B'}.
+
address@hidden
+On AIX, the @command{/bin/sh} is very slow due to its inefficient handling
+of here-documents.  A modern shell is preferable:
address@hidden
+CONFIG_SHELL=/bin/bash; export $CONFIG_SHELL
+$CONFIG_SHELL ./configure [...]
address@hidden example
+
address@hidden
+For C++ code with templates, it may be necessary to specify the way the 
compiler
+will generate the instantiations.  For Portland pgCC version5, use
address@hidden'pgCC --one_instantiation_per_object'} and avoid parallel 
@command{make}.
+
address@hidden
+On Darwin, for C++ code with templates you need two level shared libraries.
+Libtool builds these by default if @env{MACOSX_DEPLOYMENT_TARGET} is set to
+10.3 or later at @command{configure} time.  See @url{rdar://problem/4135857}
+for more information on this issue.
+
address@hidden @item
address@hidden FreeBSD @command{make} does not conform to @sc{posix} in its 
handling
address@hidden of file modification times, which causes it to loop while 
building libtool.
address@hidden Consider using a different @command{such} as GNU make instead.
+
address@hidden
+The default shell on UNICOS 9, a ksh 88e variant, is too buggy to
+correctly execute the libtool script.  Users are advised to install a
+modern shell such as GNU bash.
+
address@hidden
+Some HP-UX @command{sed} programs are horribly broken, and cannot handle
+libtool's requirements, so users may report unusual problems.  There
+is no workaround except to install a working @command{sed} (such as GNU sed)
+on these systems.
+
address@hidden
+The vendor-distributed NCR MP-RAS @command{cc} programs emits copyright
+on standard error that confuse tests on size of @file{conftest.err}.  The
+workaround is to specify @env{CC} when run configure with
address@hidden'cc -Hnocopyr'}.
+
address@hidden
+Any earlier DG/UX system with ELF executables, such as R3.10 or
+R4.10, is also likely to work, but hasn't been explicitly tested.
+
address@hidden
+On Reliant Unix libtool has only been tested with the Siemens C-compiler
+and an old version of @command{gcc} provided by Marco Walther.
+
address@hidden
address@hidden, @file{ltdl.m4} and the @file{configure.ac} files are marked
+to use autoconf-mode, which is distributed with GNU Emacs 21, Autoconf itself,
+and all recent releases of XEmacs.
+
address@hidden
+When building on some linux systems for multilib targets
address@hidden sometimes guesses the wrong paths that the linker
+and dynamic linker search by default. If this occurs, you may override
+libtool's guesses at @command{configure} time by setting the
address@hidden cache variables
address@hidden and
address@hidden respectively to the correct search
+paths.
+
address@hidden itemize
 @node Distributing
 @section Including libtool in your package