doc/notes.txt

   1    * You currently need GNU make to build the Libtool package itself.
   2
   3    * On AIX there are two different styles of shared linking, one in
   4      which symbols are bound at link-time and one in which symbols are
   5      bound at runtime only, similar to ELF.  In case of doubt use
   6      `LDFLAGS=-Wl,-brtl' for the latter style.
   7
   8    * On AIX, native tools are to be preferred over binutils; especially
   9      for C++ code, if using the AIX Toolbox GCC 4.0 and binutils,
  10      configure with `AR=/usr/bin/ar LD=/usr/bin/ld NM='/usr/bin/nm -B''.
  11
  12    * On AIX, the `/bin/sh' is very slow due to its inefficient handling
  13      of here-documents.  A modern shell is preferable:
  14           CONFIG_SHELL=/bin/bash; export $CONFIG_SHELL
  15           $CONFIG_SHELL ./configure [...]
  16
  17    * For C++ code with templates, it may be necessary to specify the
  18      way the compiler will generate the instantiations.  For Portland
  19      pgCC version5, use `CXX='pgCC --one_instantiation_per_object'' and
  20      avoid parallel `make'.
  21
  22    * On Darwin, for C++ code with templates you need two level shared
  23      libraries.  Libtool builds these by default if
  24      `MACOSX_DEPLOYMENT_TARGET' is set to 10.3 or later at `configure'
  25      time.  See `rdar://problem/4135857' for more information on this
  26      issue.
  27
  28    * The default shell on UNICOS 9, a ksh 88e variant, is too buggy to
  29      correctly execute the libtool script.  Users are advised to
  30      install a modern shell such as GNU bash.
  31
  32    * Some HP-UX `sed' programs are horribly broken, and cannot handle
  33      libtool's requirements, so users may report unusual problems.
  34      There is no workaround except to install a working `sed' (such as
  35      GNU sed) on these systems.
  36
  37    * The vendor-distributed NCR MP-RAS `cc' programs emits copyright on
  38      standard error that confuse tests on size of `conftest.err'.  The
  39      workaround is to specify `CC' when run configure with `CC='cc
  40      -Hnocopyr''.
  41
  42    * Any earlier DG/UX system with ELF executables, such as R3.10 or
  43      R4.10, is also likely to work, but hasn't been explicitly tested.
  44
  45    * On Reliant Unix libtool has only been tested with the Siemens
  46      C-compiler and an old version of `gcc' provided by Marco Walther.
  47
  48    * `libtool.m4', `ltdl.m4' and the `configure.ac' files are marked to
  49      use autoconf-mode, which is distributed with GNU Emacs 21,
  50      Autoconf itself, and all recent releases of XEmacs.
  51
  52    * When building on some GNU/Linux systems for multilib targets
  53      `libtool' sometimes guesses the wrong paths that the linker and
  54      dynamic linker search by default. If this occurs, you may override
  55      libtool's guesses at `configure' time by setting the `autoconf'
  56      cache variables `lt_cv_sys_lib_search_path_spec' and
  57      `lt_cv_sys_lib_dlsearch_path_spec' respectively to the correct
  58      search paths.
  59
  60