From: Peter O'Gorman Date: Tue, 29 Jan 2008 03:55:15 +0000 (+0000) Subject: * doc/Makefile.am, doc/notes.texi, doc/libtool.texi: Move the X-Git-Tag: release-1-5-26~2 X-Git-Url: http://git.ipfire.org/gitweb/gitweb.cgi?a=commitdiff_plain;h=b4a8e5838ab41d2dfa0c515e6e2053558fb4fdb8;p=thirdparty%2Flibtool.git * doc/Makefile.am, doc/notes.texi, doc/libtool.texi: Move the platform specific notes to notes.texi and generate notes.txt. Reported by Tim Rice --- diff --git a/ChangeLog b/ChangeLog index 70a55be4a..c6513e6ea 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,9 @@ 2008-01-29 Peter O'Gorman + * doc/Makefile.am, doc/notes.texi, doc/libtool.texi: Move the + platform specific notes to notes.texi and generate notes.txt. + Reported by Tim Rice + Search the compiler path too. * libtool.m4 (compiler_lib_search_dirs): New variable. * ltmain.in: Use it. diff --git a/doc/Makefile.am b/doc/Makefile.am index 98824ceef..f84e487af 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -2,4 +2,12 @@ AUTOMAKE_OPTIONS = gnits info_TEXINFOS = libtool.texi -libtool_TEXINFOS = PLATFORMS fdl.texi +libtool_TEXINFOS = PLATFORMS fdl.texi notes.texi +EXTRA_DIST = notes.txt + +all-local: $(srcdir)/notes.txt + +$(srcdir)/notes.txt: notes.texi + cd $(srcdir) && \ + $(MAKEINFO) --no-headers $(MAKEINFOFLAGS) -o notes.txt notes.texi + diff --git a/doc/libtool.texi b/doc/libtool.texi index ff4181980..039ec78d6 100644 --- a/doc/libtool.texi +++ b/doc/libtool.texi @@ -1850,90 +1850,8 @@ 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. -@itemize +@include notes.texi -@item -Note that Sun C++ compiler versions before 5.6 may need some special -setup to link properly against shared versions of the C++ standard libraries. -See @url{http://lists.gnu.org/archive/html/libtool/2005-08/msg00088.html} for -more information. - -@item -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 ELF@. In case of doubt use @code{LDFLAGS=-Wl,-brtl} for the latter style. - -@item -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 -@code{AR=/usr/bin/ar LD=/usr/bin/ld NM='/usr/bin/nm -B'}. - -@item -On AIX, the @command{/bin/sh} is very slow due to its inefficient handling -of here-documents. A modern shell is preferable: -@example -CONFIG_SHELL=/bin/bash; export $CONFIG_SHELL -$CONFIG_SHELL ./configure [...] -@end example - -@c @item -@c FreeBSD @command{make} does not conform to @sc{posix} in its handling -@c of file modification times, which causes it to loop while building libtool. -@c Consider using a different @command{such} as GNU make instead. - -@item -Note in some cases you might need to put ABI-changing compiler flags -into the compiler name. For example, use of -@example - configure CC='gcc -m32' -@end example -rather than -@example - configure CC=gcc CFLAGS=-m32 LDFLAGS=-m32 -@end example -might help with this Libtool release. - -@item -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. - -@item -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. - -@item -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 -@code{CC='cc -Hnocopyr'}. - -@item -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. - -@item -On Reliant Unix libtool has only been tested with the Siemens C-compiler -and an old version of @command{gcc} provided by Marco Walther. - -@item -@file{libtool.m4}, @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. - -@item -When building on some linux systems for multilib targets -@command{libtool} 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 -@command{autoconf} cache variables -@code{lt_cv_sys_lib_search_path_spec} and -@code{lt_cv_sys_lib_dlsearch_path_spec} respectively to the correct search -paths. - -@end itemize @node Distributing @section Including libtool in your package diff --git a/doc/notes.texi b/doc/notes.texi new file mode 100644 index 000000000..bda8c464d --- /dev/null +++ b/doc/notes.texi @@ -0,0 +1,84 @@ +@itemize + +@item +Note that Sun C++ compiler versions before 5.6 may need some special +setup to link properly against shared versions of the C++ standard libraries. +See @url{http://lists.gnu.org/archive/html/libtool/2005-08/msg00088.html} for +more information. + +@item +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 ELF@. In case of doubt use @code{LDFLAGS=-Wl,-brtl} for the latter style. + +@item +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 +@code{AR=/usr/bin/ar LD=/usr/bin/ld NM='/usr/bin/nm -B'}. + +@item +On AIX, the @command{/bin/sh} is very slow due to its inefficient handling +of here-documents. A modern shell is preferable: +@example +CONFIG_SHELL=/bin/bash; export $CONFIG_SHELL +$CONFIG_SHELL ./configure [...] +@end example + +@c @item +@c FreeBSD @command{make} does not conform to @sc{posix} in its handling +@c of file modification times, which causes it to loop while building libtool. +@c Consider using a different @command{such} as GNU make instead. + +@item +Note in some cases you might need to put ABI-changing compiler flags +into the compiler name. For example, use of +@example + configure CC='gcc -m32' +@end example +rather than +@example + configure CC=gcc CFLAGS=-m32 LDFLAGS=-m32 +@end example +might help with this Libtool release. + +@item +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. + +@item +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. + +@item +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 +@code{CC='cc -Hnocopyr'}. + +@item +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. + +@item +On Reliant Unix libtool has only been tested with the Siemens C-compiler +and an old version of @command{gcc} provided by Marco Walther. + +@item +@file{libtool.m4}, @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. + +@item +When building on some linux systems for multilib targets +@command{libtool} 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 +@command{autoconf} cache variables +@code{lt_cv_sys_lib_search_path_spec} and +@code{lt_cv_sys_lib_dlsearch_path_spec} respectively to the correct search +paths. + +@end itemize