libtool: Configure notes

1 
1 5.4.2 Platform-specific configuration notes
1 -------------------------------------------
1 
1 While Libtool tries to hide as many platform-specific features as
1 possible, some have to be taken into account when configuring either the
1 Libtool package or a libtoolized package.
1 
1    * You currently need GNU make to build the Libtool package itself.
1 
1    * On AIX there are two different styles of shared linking, one where
1      symbols are bound at link-time and one where symbols are bound at
1      runtime only, similar to ELF.  In case of doubt use
1      'LDFLAGS=-Wl,-brtl' for the latter style.
1 
1    * On AIX, native tools are to be preferred over binutils; especially
1      for C++ code, if using the AIX Toolbox GCC 4.0 and binutils,
1      configure with 'AR=/usr/bin/ar LD=/usr/bin/ld NM='/usr/bin/nm -B''.
1 
1    * On AIX, the '/bin/sh' is very slow due to its inefficient handling
1      of here-documents.  A modern shell is preferable:
1           CONFIG_SHELL=/bin/bash; export $CONFIG_SHELL
1           $CONFIG_SHELL ./configure [...]
1 
1    * For C++ code with templates, it may be necessary to specify the way
1      the compiler will generate the instantiations.  For Portland pgCC
1      version5, use 'CXX='pgCC --one_instantiation_per_object'' and avoid
1      parallel 'make'.
1 
1    * On Darwin, for C++ code with templates you need two level shared
1      libraries.  Libtool builds these by default if
1      'MACOSX_DEPLOYMENT_TARGET' is set to 10.3 or later at 'configure'
1      time.  See <rdar://problem/4135857> for more information on this
1      issue.
1 
1    * The default shell on UNICOS 9, a ksh 88e variant, is too buggy to
1      correctly execute the libtool script.  Users are advised to install
1      a modern shell such as GNU bash.
1 
1    * Some HP-UX 'sed' programs are horribly broken, and cannot handle
1      libtool's requirements, so users may report unusual problems.
1      There is no workaround except to install a working 'sed' (such as
1      GNU sed) on these systems.
1 
1    * The vendor-distributed NCR MP-RAS 'cc' programs emits copyright on
1      standard error that confuse tests on size of 'conftest.err'.  The
1      workaround is to specify 'CC' when run configure with 'CC='cc
1      -Hnocopyr''.
1 
1    * Any earlier DG/UX system with ELF executables, such as R3.10 or
1      R4.10, is also likely to work, but hasn't been explicitly tested.
1 
1    * On Reliant Unix libtool has only been tested with the Siemens
1      C-compiler and an old version of 'gcc' provided by Marco Walther.
1 
1    * 'libtool.m4', 'ltdl.m4' and the 'configure.ac' files are marked to
1      use autoconf-mode, which is distributed with GNU Emacs 21, Autoconf
1      itself, and all recent releases of XEmacs.
1 
1    * When building on some GNU/Linux systems for multilib targets
1      'libtool' sometimes guesses the wrong paths that the linker and
1      dynamic linker search by default.  If this occurs for the dynamic
1      library path, you may use the 'LT_SYS_LIBRARY_PATH' environment
1      variable to adjust.  Otherwise, at 'configure' time you may
1      override libtool's guesses by setting the 'autoconf' cache
1      variables 'lt_cv_sys_lib_search_path_spec' and
1      'lt_cv_sys_lib_dlsearch_path_spec' respectively.
1