[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
FYI backport notes.texi from HEAD
From: |
Peter O'Gorman |
Subject: |
FYI backport notes.texi from HEAD |
Date: |
Thu, 24 Jan 2008 01:29:08 -0600 |
User-agent: |
Thunderbird 2.0.0.9 (X11/20071115) |
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
- FYI backport notes.texi from HEAD,
Peter O'Gorman <=
- Re: FYI backport notes.texi from HEAD, Ralf Wildenhues, 2008/01/24
- Re: FYI backport notes.texi from HEAD, Peter O'Gorman, 2008/01/24
- Re: FYI backport notes.texi from HEAD, Tim Rice, 2008/01/24
- Re: FYI backport notes.texi from HEAD, Peter O'Gorman, 2008/01/24
- Re: FYI backport notes.texi from HEAD, Ralf Wildenhues, 2008/01/24
- Re: FYI backport notes.texi from HEAD, Peter O'Gorman, 2008/01/24
- Re: FYI backport notes.texi from HEAD, Tim Rice, 2008/01/24
- Re: FYI backport notes.texi from HEAD, Peter O'Gorman, 2008/01/28