ltmain.in: Use func_warning for all warnings
[libtool.git] / NEWS
blob7750430ae45f00a46791856d7c22b9c48d956fcc
1 NEWS - list of user-visible changes between releases of GNU Libtool
3 * Noteworthy changes in release ?.? (????-??-??) [?]
5 ** Changes in supported systems or compilers:
7   - Removed support for bitrig (*-*-bitrig*).
9 * Noteworthy changes in release 2.4.7 (2022-03-16) [stable]
11 ** New features:
13   - Libtool script now supports (configure-time and runtime) ARFLAGS
14     variable, which obsoletes AR_FLAGS.  This is due to naming conventions
15     among other *FLAGS and to be consistent with Automake's ARFLAGS.
17   - Gnulib testsuite is enabled and run during 'make check'.
19   - Support the Windows version of the Intel C Compiler (icl) in
20     libtool script.
22   - Pass '-fsanitize=*' flags for GCC and LLVM, and '-specs=*' for GCC
23     to linker.
25   - Pass '-Xassembler=*' and '-Wa,*' flag to compilers and linkers.
27   - The variable 'FILECMD' with default value of '/usr/bin/file' was used to
28     replace existing hard coded references to '/usr/bin/file'.
30   - Add MidnightBSD support.
32 ** Important incompatible changes:
34   - Libtool changed ARFLAGS/AR_FLAGS default from 'cru' to 'cr'.
36   - Do not pass '-pthread' to Solaris linker.
38   - 'libtool' and 'libtoolize' scripts now use '#! /usr/bin/env sh' shebang.
39     Previously '#! /bin/sh' was used, which presents challenges for
40     containerized environments.
42 ** Bug fixes:
44   - Fix significant slowdown of libtoolize for certain projects (regression
45     introduced in 2.4.3 release) caused by infinite m4 macro recursion.
47   - Mitigate the slowdown of libtool script (introduced in v2.4.3) caused by
48     increased number of calls to '$SED $sed_quote_subst' (bug#20006).
50   - Properly parse and export TLS symbols on AIX.
52   - Various bug fixes surrounding use of 'sed'.
54   - Darwin systems set proper "allow undefined" flag on OSX 11, and
55     PowerPC 10.5.
57   - Removed some deprecated tests related to 'Makefile.inc' files.
59 * Noteworthy changes in release 2.4.6 (2015-02-15) [stable]
61 ** New features:
63   - LT_SYS_LIBRARY_PATH can be set in config.site, or at configure time
64     and persists correctly in the generated libtool script.
66 ** Bug fixes:
68   - Fix a race condition in ltdl dryrun test that would cause spurious
69     random failures of that test.
71   - LT_SYS_DLSEARCH_PATH is munged correctly.
74 * Noteworthy changes in release 2.4.5 (2015-01-19) [stable]
76 ** New features:
78   - Libtoolize searches for the best available M4 on the user PATH at
79     runtime, rather than settling for the first one found.
81   - Support munging sys_lib_dlsearch_path_spec with LT_SYS_LIBRARY_PATH
82     environment variable.
84 ** Bug fixes:
86   - Bail out at configure time if the installed M4 is not sufficient
87     for the purposes of libtoolize.
89   - freebsd-elf library versioning was upgraded incorrectly in 2.4.4,
90     but now works properly again.
92   - Fix a 2.4.4 regression so that libltdl subprojects do not warn
93     about missing libltdl/libltdl directory as in prior releases.
95   - When using Sun C++ on Solaris or GNU/Linux we used to set libtool's
96     postdeps permanently, based on the contents of $CXX and $CXXFLAGS at
97     configure time, which was brittle and error-prone.  Now, we no
98     longer check for a SunCC ABI at configure time, but augment the
99     postdeps at libtool time based on the current invocation flags on
100     each call.
102 ** Changes in supported systems or compilers:
104   - /usr/local prefixed rpaths are now added to the link-line on
105     ia64-hp-hpux*, because the default system runtime loader path does
106     not contain them.
108   - Previously, when using Sun C++ on Solaris or GNU/Linux, `-Cstd -Crun`
109     flags were added to $postdeps unless CXX or CXXFLAGS contained
110     `-library=stlport4`.  Newer releases have added other compiler flags
111     that are also incompatible with `-Cstd -Crun`, so now we don't add
112     them if any of `-std=c++[0-9][0-9]`, `-library=stdcxx4` or
113     `-compat=g` were found in CXX or CXXFLAGS when the Sun C++ compiler
114     is detected.
117 * Noteworthy changes in release 2.4.4 (2014-11-29) [stable]
119 ** New features:
121   - Libltdl maintains its own fork of argz, with macros and files in
122     the LT_ and lt__ namespaces (resp.) where they cannot clash with
123     client projects' use of gnulib argz.
125 ** Bug fixes:
127   - Installation of 'libtoolize' once again obeys '--program-prefix',
128     '--program-suffix' and '--program-transform-name' configure options.
130   - `libtoolize` doesn't remove any files that it can't reinstall,
131     including old versions of the snippet directory, and gnulib's
132     version of the argz module and supporting files.
134   - LT_FUNC_DLYSM_USCORE now works correctly on systems that don't
135     support self dlopen()ing.
137 ** Important incompatible changes:
139   - LT_LIB_DLLOAD no longer prepends -ldl or -ldld to LIBS, causing
140     duplicate occurrences in libltdl link lines.  If you need to
141     add a library for dlopen() or shl_load() in your Makefile, then
142     use $(LIBADD_DLOPEN) or $(LIBADD_SHL_LOAD) respectively.  If you
143     are using libltdl, this all happens automatically, and the only
144     difference you'll see is no more duplicated library names in the
145     verbose link line.
147 ** Changes in supported systems or compilers:
149   - Preliminary support for tcc on linux*.  Although it already worked
150     sometimes in previous releases, making sure to set LD correctly now
151     avoids mis-matching GNU ld with tcc:
153        ./configure CC=tcc LD=tcc
155   - Added -os2dllname option to work around 8 character base name
156     limit on OS/2.  The option has no effect on other systems.
158   - Support for DLL versioning, -export-symbols and -export-symbols-regex
159     on OS/2.
161   - Support filename-based shared library versioning on AIX. See manual
162     for details.
165 * Noteworthy changes in release 2.4.3 (2014-10-27) [stable]
167 ** New features:
169   - Moved to gnulib release infrastructure.
171   - M4 is now used for scanning the M4 macros in your configure.ac that
172    'libtoolize' looks at to determine what files you want, and where you
173     would like them installed.  This means that you can compose your
174     version number or any other argument that Libtoolize needs to know at
175     M4 time using git-version-gen from gnulib, for example.
177   - Invoking 'libtoolize --ltdl' no longer maintains a separate autoconf
178     macro directory in the libltdl tree, but automatically adjusts the
179     installed libltdl configuration files to share whatever macro
180     directory is declared by the parent project. (Note: if you were
181     already sharing a macro directory with AC_CONFIG_MACRO_DIR(ltdl/m4)
182     or similar, that still works as does any other directory choice).
184   - Invoking 'libtoolize --ltdl' no longer maintains a separate auxiliary
185     scripts directory in the libltdl tree, but automatically adjusts the
186     installed libltdl configuration files to share whatever auxiliary
187     scripts directory is declared by the parent project. (Note: if you
188     were already sharing an auxiliary directory with subproject libltdl
189     using AC_CONFIG_AUX_DIR(ltdl/config) or similar, that still works as
190     does any other directory choice).
192   - The legacy tests have all been migrated to the Autotest harness.
194   - The Autotest testsuite can be run without the especially time consuming
195     tests with:
197         make check-local TESTSUITEFLAGS='-k "!expensive"'
199 ** Bug fixes:
201   - Fix a long-standing latent bug in autom4te include path for autotests
202     with VPATH builds.
203   - Fix a long-standing latent bug in libtoolize that could delete lines
204     from libltdl/Makefile.am in recursive mode due to underquoting in a
205     sed script.
206   - Fix a long-standing bug in libtoolize, by outputting the 'putting
207     auxiliary files in' header with 'libtoolize --ltdl --subproject'.
208   - Fix a long-standing bug in libtoolize subproject installation, by not
209     installing a set of autoconf macro files into the parent project if
210     there is no configure.ac present to use them.
211   - The libtoolize subproject mode selector is now named '--subproject'
212     and is equivalent to the implied '--subproject' mode when no other
213     mode is selected; '--standalone' never worked, and is no longer
214     accepted.
215   - Libtool and libtoolize no longer choke on paths with a comma in them.
216   - In the case where $SHELL does not have the same enhanced features
217     (e.g. the ability to parse 'var+=append') as $CONFIG_SHELL, libtool
218     will now correctly fallback to using only vanilla shell features
219     instead of failing with a parse at startup.
220   - Correctly recognize import libraries when Microsoft dumpbin is used
221     as the name lister and extend the dumpbin wrapper to find symbols
222     in import libraries using the -headers option of dumpbin. Also fix a
223     bug in the dumpbin wrapper that could lead to broken symbol listings
224     in some corner cases.
225   - Use the improved Microsoft dumpbin support to mend preloading of
226     import libraries for Microsoft Visual C/C++.
227   - No longer mangle module-definition (.def) files when feeding them to
228     the Microsoft Visual C/C++ linker via the -export-symbols argument to
229     the libtool script, thus matching how .def files are handled when
230     using GNU tools.
231   - Recognize more variants (e.g. those starting with a LIBRARY statement)
232     of module-definitions (.def) files when using them instead of a raw
233     list of symbols to export.
234   - Fix a long-standing bug when using libtoolize without automake; we
235     no longer remove install-sh with --force, since it's not a file
236     libtoolize will reinstall without --install..
238 ** Important incompatible changes:
240   - GNU M4 is required to run libtoolize in a directory with a
241     'configure.ac' (or 'configure.in') that needs tracing to determine
242     what modes and directories have been specified.
244   - The use of the idiosyncratically named 'Makefile.inc' in nonrecursive
245     libltdl builds is deprecated, although it will be supported for one
246     more year or until the next release, whichever takes longer.  Please
247     upgrade to the more standard naming of 'ltdl.mk' in keeping with other
248     GNU projects.
250   - libtoolize now behaves consistenty in respect of multiple directory
251     arguments to ACLOCAL_AMFLAGS and multiple invocations of AC_CONFIG-
252     _MACRO_DIRS, where the first directory is always selected.  Previous
253     releases took the first ACLOCAL_AMFLAGS argument, but the last
254     invocation of AC_CONFIG_MACRO_DIRS.
256   - The libtoolize program now advises use of the new Autoconf
257     AC_CONFIG_MACRO_DIRS declaration.  If you follow that advice, all
258     your developers will need at least autoconf-2.70 and automake-1.13
259     to rebootstrap your probject.  If you still need to support
260     bootstrap with older Autotools, then you should add the following
261     to your configure.ac file:
263         m4_ifndef([AC_CONFIG_MACRO_DIRS],
264             [m4_define([AC_CONFIG_MACRO_DIRS],
265                 m4_defn([AC_CONFIG_MACRO_DIR]))])
267   - Overhead of probing for a non-backslash crippled echo equivalent
268     during initialization of every script has been removed in favor of
269     trusting that "printf %s\n" works out of the box on all non-museum
270     host architectures.  Manually setting ECHO appropriately in the
271     build environment will be necessary on some ancient architectures.
273 ** Changes in supported systems or compilers:
275   - Support for bitrig (*-*-bitrig*).
277   - Solaris 7 and earlier requires ECHO=/usr/ucb/echo in the build
278     environment, to build and use libtool.
280 New in 2.4.2 2011-10-17: git version 2.4.1a, Libtool team:
282 * New features:
284   - The --with-pic configure option now supports a list of comma-separated
285     package names.  This can be used to build some static libraries with PIC
286     objects while building others with non-PIC objects.
288   - Initial support for Go, using the gccgo compiler.
290   - On Mac OS X .dylib is now tried as well as .so with
291     lt_dlopenext().
293 * Bug fixes:
295   - The generic approximation of the command line length limit (when getconf is
296     not available) works again.  Regression introduced in v2.2.6-39-g9c3d4d8.
297   - The bug that leaked developer tool paths into the release tarballs
298     from ./bootstrap is fixed.
299   - Improved support for the Cuda Compiler Driver (nvcc) on Darwin.
300   - For GCC LTO support, the -fuse-linker-plugin switch is now also removed
301     when computing compiler postdeps.
303 * Important incompatible changes:
305   - The undocumented hardcode_libdir_flag_spec_ld tag variable has been
306     removed in favor of using hardcode_libdir_flag_spec with $wl set to empty.
308 * Changes in supported systems or compilers:
310   - Fixes for gfortran on Darwin, XL Fortran on GNU/Linux.
311   - Support for FreeBSD 1.x (outdated since 1994) has been removed.
313 New in 2.4 2010-09-22: git version 2.2.11a, Libtool team:
315 * New features:
317   - Sysroot support.  This allows you to build cross-compiled packages
318     with the same prefix that will be used on the destination machine,
319     and still find dependent libraries under the compiler's "sysroot".
320     Without sysroot support, paths internal to the build system may leak
321     into the product of the build.
323     Sysroot support is disabled unless the --with-sysroot configure
324     option is passed to configure, because .la files generated with
325     sysroot support will _not_ be usable in general with older Libtools.
327   - On non-cygwin Windows systems, we now lookup potential library
328     file names without regard to file name case.
329   - The old testsuite now uses the 'parallel-tests' Automake test driver
330     now for more concurrency and better test logging.  For this, tests are
331     run in verbose mode by default now.
333 * Important incompatible changes:
335   - Autoconf 2.62 and Automake 1.11.1 or newer are now required for
336     bootstrapping Libtool.  For using Libtool in your own projects,
337     Autoconf 2.59 and Automake 1.9.6 should still work.
338   - The fix_srcfile_path variable has been replaced by a more thorough
339     mechanism triggered by the to_tool_file_cmd variable.
341 * Changes in supported systems or compilers:
343   - Initial support for the Microsoft C/C++ Compiler, with help from
344     the compile script in unreleased Automake 1.12. Override the manifest
345     tool used to embed the manifest resource through the environment
346     variable MANIFEST_TOOL. Please note that the import library naming
347     has changed (from foo-2.lib to foo.dll.lib) from when the code lived
348     in its own git branch.
349   - Initial support for the NAG Fortran compiler on GNU/Linux.
351 * Bug fixes:
353   - The 'check-interactive' and 'check-noninteractive' convenience make
354     targets now also work for the old testsuite.
355   - Warnings from Autoconf v2.67-36-g1e604ec about incomplete programs
356     passed to AC_*_IFELSE tests have been fixed.
357   - On IRIX, the test for -Wl,-exported_symbol now also works with gfortran.
359 New in 2.2.10 2010-06-10: git version 2.2.9a, Libtool team:
361 * New features:
363   - On non-cygwin Windows systems, we no longer try to lookup the POSIX
364     format path recorded in $libdir of a pseudo-library when looking up
365     the location of the library with the native tools.
367 New in 2.2.8 2010-06-05: git version 2.2.7c, Libtool team:
369 * No new features:
371   - Bumped version number and promoted 2.2.7b release candidate to a full
372     stable release.
374 New in 2.2.7b 2010-05-20: git version 2.2.7a, Libtool team:
376 * New features:
378   - Libtool ships and installs man pages for libtool and libtoolize now.
379   - New libtool command line flag --help-all.
380   - New libtool command line flag --no-silent (with alternate spelling
381     --no-quiet). This flag (re)enables the default informational messages,
382     but has no effect on so-called "verbose" output messages.
383   - New libtool command line flag --no-verbose, which disables only
384     the extra "verbose" output messages and has no effect on the
385     default informational messages.
386   - New convenience make targets 'check-noninteractive' to avoid long testsuite
387     runs on Windows with popup windows in the middle, and 'check-interactive'
388     for the complement set of tests.
389   - New link mode flag -bindir to specify the location for installed PE DLLs.
390   - Wrapper scripts and wrapper executables for programs linked against
391     uninstalled shared libraries now support command-line options --lt-debug
392     and --lt-dump-script.
394 * Important incompatible changes:
396   - The wrapper command line option support described above introduces the
397     following incompatibility: the wrapper will remove any command line
398     options that begin with '--lt-*' from the argument list before launching
399     (uninstalled) programs. Any '--lt-*' option on the command line not
400     recognized by the wrapper will result in an error.
401   - The type of the symbol lists variables (lt_*_LTX_preloaded_symbols) has
402     been fixed in the manual and in a couple of tests to match the actual
403     implementation.
405 * Changes in supported systems or compilers:
407   - Improved support for 64bit Windows (mingw64).
408   - Improved support for cegcc (Windows CE/PocketPC).
409   - Support for GNU/kOpenSolaris (kopensolaris*-gnu).
410   - Initial support for compilers on BlueGene BG/P.
411   - Improved support for Atari FreeMiNT.
412   - With binutils 2.19.50+, shared libraries can be built on AIX.
413   - Initial support for the Cuda Compiler Driver on GNU/Linux.
414   - Support for Haiku (i586-pc-haiku).
415   - Initial support for GCC link-time optimization (LTO) flags.
417 * Bug fixes:
419   - Fix 2.2.6 regression that prevented using the libltdl macros together
420     with Autoconf 2.59 ('possibly undefined macro: LT_LIBEXT').
421   - Fix 2.2.4 regression that caused arguments with special characters
422     to be mangled by the compile wrapper for uninstalled programs on MinGW.
423   - libtool command line flag --verbose now also enables explicit
424     verbose output, in addition to its previous behavior of (re)enabling
425     only the default informational output. See New Features, --no-silent.
426   - Link tests are guarded by cache variables so they can be avoided for
427     bootstrapping purposes (e.g., when link tests are not possible).
428   - Argument mangling of execute mode has been improved (i.e., lessened).
429   - Fix 2.1b regression that caused nm to not be the default name lister.
430     The regression affected mainly (arguably broken) cross compiles.
431   - Fix long standing bug that caused compiler checks for Fortran and
432     C++ compilers to run twice.
433   - Link mode works around a parallel build failure on Darwin 9.6.0 due
434     to the 'ar' 'flock'ing an archive upon extraction, by protecting the
435     extraction of convenience archives with a lock.
436   - The Libtool macro files do not contain instances of __oline__ any more,
437     easing merges for configure scripts that are added to version control.
438   - Fix ancient bug where "-Wc," was turned into "$wl" (typically "-Wl,")
439     when using the compiler driver to link programs. Now "-Wc," is stripped
440     just as it is when linking libraries through the compiler driver.
441   - Symbol versioning works with the GNU gold linker now.
442   - Fixes for detection of shared library dependencies on MinGW systems.
443   - Fixed Sun compiler detection on Solaris with sunCC, sunf77 etc. names.
445 * Miscellaneous changes:
447   - The manual is distributed under the terms of the GNU FDL 1.3 now.
449 New in 2.2.6 2008-09-05: git version 2.2.5a, Libtool team:
451 * New features:
453   - New lt_dloadvise_preload() call to set a hint that only preloadeded
454     modules can be opened.
455   - libtoolize no longer removes config.guess and config.sub, even when
456     --install is passed.
458 * Changes in supported systems or compilers:
460   - Fixes for ifort on Darwin, and newer Intel compilers (icc 10, ifort 9)
461     on GNU/Linux.
462   - Fixes for cwrapper (cygwin/mingw) under -stdc=c99.
463   - Support cross compile of MinGW with Wine.
464   - Initial support for cegcc (Windows CE/PocketPC) cross compilation.
465   - Initial support for lf95 (Lahey Fortran 8.1) on GNU/Linux.
467 * Bug fixes:
469   - Several testsuite issues have been fixed, thanks to user feedback.
471   - Fix 2.2 regression that caused argz symbols to be exported from
472     libltdl unrenamed on systems that do not have working argz.
474   - Revert "lt_dlopen(NULL) works on AIX again.". It was not the
475     correct fix.
477   - Diagnose '-L' arguments correctly.
479   - Libtool no longer tries to open devices as files in execute mode.
481   - Libtool no longer removes *.gcno profile information from GCC.
483 New in 2.2.4: 2008-05-04: git version 2.2.3a, Libtool team:
485 * New features:
487   - New libtoolize option --no-warn, for users that want to continue to
488     use old libtool style without being nagged.
489   - Options --debug, --no-warn, --quiet and --verbose can be passed to
490     libtoolize through the environment variable LIBTOOLIZE_OPTIONS, for
491     cleaner interaction between the user and libtoolize when called by
492     autoreconf.
494 * Bug fixes:
496   - The documentation for lt_dlopenadvise showed the wrong type for
497     the lt_dladvise parameter.
498   - The public declarations for lt_dlhandle and lt_dladvise are now
499     incomplete struct types rather than void*, which means that nearly
500     all casting is eliminated allowing the compiler to provide more
501     type checking.
502   - libtoolize no longer reports up-to-date files that it would have
503     copied, unless --force is passed.
504   - No longer reports that lt~obsolete.m4 needs to be added to aclocal.m4
505     when it is already there.
506   - When 'aclocal' copied the libtool macros directly into 'aclocal.m4'
507     (i.e. AC_CONFIG_MACRO_DIR is not being used), libtoolize no longer
508     reports that all macros need to be added to 'aclocal.m4', and
509     diagnoses only the macro files that are missing or not up-to-date.
510   - libtoolize now advises use of AC_CONFIG_MACRO_DIR to keep matching
511     libtool macros in-tree where appropriate.
512   - libtoolize now advises use of 'ACLOCAL_AMFLAGS = -I m4' (or
513     equivalent) where appropriate, and errors out when ACLOCAL_AMFLAGS
514     names a different directory to AC_CONFIG_MACRO_DIR.
516 New in 2.2.2: 2008-04-01: CVS version 2.2.1a, Libtool team:
518 * New features:
520   - In compile mode, compiler output occurs in the user locale.  This
521     feature has been present in 1.5.26 but not in 2.2.
523 * Changes in supported systems or compilers:
525   - Initial shared library support for AmigaOS4 on powerpc.
527 * Bug fixes:
529   - Fix 2.2 regression in libltdl that causes memory corruption upon
530     repeated 'lt_dlinit(); lt_dlexit()'.
531   - Fix 2.2 regression in libltdl that skipped the dlopen loader if
532     the system also supports other loaders (e.g., Cygwin, HP-UX).
533   - Fix 2.2 regression in that 'libtool --mode=execute CMD ARGS' does not
534     transform ARGS that do not look like shell or C wrappers of libtool
535     programs.
536   - Fix 2.2 regression that kept cross-compiling to w32 from working.
537   - Several testsuite issues have been fixed, thanks to user feedback.
539 New in 2.2: 2008-03-01; CVS version 2.1c, Libtool team:
541 * Bug fixes:
543   - argz.c, lt__dirent.c and lt__strl.c are correctly distributed with
544     parent projects using nonrecursive libltdl.
545   - libtoolize no longer tries to install libtool files when libltdl is
546     used in a non-autoconf parent package.
547   - Don't add the CXX tag to libtool when there is no C++ compiler, even
548     if AC_PROG_CXX sets a default g++ compiler where no such compiler
549     actually exists.
550   - make distcheck DISTCHECK_CONFIGURE_FLAGS=--disable-ltdl-install
551     works again.
553 New in 2.1b: 2008-02-01; CVS version 2.1a, Libtool team:
555 * Important incompatible changes and obsoleted features:
557   - Removed deprecated APIs from libltdl: lt_dlcaller_register,
558     lt_dlhandle_next, lt_dlhandle_find, lt_dlforeach, lt_dlmutex_register,
559     lt_dlmutex_lock, lt_dlmutex_unlock, lt_dlmutex_seterror,
560     lt_dlmutex_geterror, lt_dlmalloc, lt_dlrealloc, lt_dlfree.
561   - The Libtool and libltdl macros and the testsuite now assume a C89
562     environment, consequently do not test for headers such as string.h,
563     strings.h, memory.h any more.
564   - Fix regression in libltdl symbol exports on Cygwin. Side effect:
565     LT_GLOBAL_DATA and LT_SCOPE are now explicitly defined as
566     declspec(dllexport), bypassing auto-export logic on Cygwin.
567     This tracks existing behavior on MinGW.
568   - The libtool script has been optimized a bit for more modern shells.
569     This breaks use of the stdin file descriptor in libtool, and can
570     break if a different shell is used to execute the libtool script
571     than the one it was configured for.
572   - The macros AC_ENABLE_SHARED, AC_DISABLE_SHARED, AC_ENABLE_STATIC, and
573     AC_DISABLE_STATIC have been un-deprecated after deprecation in
574     1.9b.
575   - The macro LT_WITH_LTDL has been renamed to LTDL_INIT.
576   - Fixed a branch-1-5/HEAD regression to only link uninstalled libraries
577     statically with '-static'.  In order to compensate for this, there
578     is a new link flag '-static-libtool-libs' to provide the previous
579     '-static' semantics.
581 * New features:
583   - Fix installation of libltdl so that it does not need Autoconf and
584     Automake installed, in order to be usable in another package.  This
585     lifts the restrictions introduced in 1.9b.
586   - Default convenience or installable libltdl builds can optionally
587     be declared using new 'convenience' or 'installable' options to the
588     LTDL_INIT macro (as an alternative to individual LTDL_CONVENIENCE
589     or LTDL_INSTALLABLE invocations).
590   - New configure-time options to allow libltdl parent project builder
591     to choose between installed and shipped libltdl, when invoking
592     LTDL_INIT: --with-included-ltdl, --with-ltdl-include,
593     --with-ltdl-lib.
594   - New LT_CONFIG_LTDL_DIR macro to specify a different directory name
595     for a convenience libltdl.
596   - libtoolize has been completely overhauled.
597   - 'libtoolize --install' now also installs 'install-sh'.
598   - New libtoolize options: --non-recursive, --recursive, --subproject.
599     These options control the way libltdl is installed into a package by
600     libtoolize.  The new recursive and non-recursive build modes for
601     libltdl don't require a subconfigure any more.
602     The Libtool package itself builds libltdl nonrecursively.
603   - The 'nonrecursive', 'recursive' and 'subproject' libltdl build
604     modes are given as LTDL_INIT options.
605   - New make variable LTDLDEPS for use in output_DEPENDENCIES.
606   - New multi-module-loader safe libltdl handle iteration APIs:
607     lt_dlhandle_iterate, lt_dlhandle_fetch, lt_dlhandle_map.
608   - New lt_dlinterface_register to maintain separation of concerns
609     between modules loaded by different libraries.
610   - New lt_dlopenadvise takes a new lt_dladvise type argument, which
611     lets the caller request local or global symbol visibility from the
612     module loader with lt_dladvise_local and lt_dladvise_global
613     respectively.  If neither is given, or if lt_dlopen (or lt_dlopenext)
614     are called, then the system default module symbol visibility is used.
615   - The new lt_dladvise_init/lt_dladvise_destroy based APIs also allow
616     caller requests for a filename extension search with lt_dladvise_ext,
617     and for marking a module unloadable with lt_dladvise_resident.
618   - Allow shell special characters like '$' in source file names, but
619     not in object names, to enhance GCJ support.
620   - An entire new Autotest-based testsuite in addition to the old one.
621     Both testsuites have been made more useful for testing
622     cross-compilers.  The new testsuite exposes many more issues, but
623     may also be a little rocky on exotic systems.
624   - In 1.9b, a new variable inherited_linker_flags has been added to the
625     libtool library files.  This variable takes flags that should be
626     used by dependent libraries and programs, but that do not fit into
627     'dependency_libs' for both clarity and backward-compatibility.
629 * Changes in supported systems or compilers:
631   - Removed bitrotted support for xlc on Mac OS X.
632   - Detection of compiler wrappers distcc/ccache and $host_alias prefix.
633   - Basic support for PIE (position-independent executables).
634   - Support for DragonFly BSD, improved support for FreeBSD.
635   - Improved support for GNU/kFreeBSD and GNU/NetBSD.
636   - Support for Interix 3 (Windows SFU) and newer versions.
637   - Support for AIX 6.1.
638   - Improved support for UnixWare.
639   - Initial support for RDOS.
640   - Initial Support for FC (modern Fortran).
641   - Support for Portland Group compiler, the Sun compiler suite on GNU/Linux,
642     and initial support for the IBM compiler suite on GNU/Linux/ppc.
643   - Support for linux-dietlibc ('diet' as well as 'diet-dyn', separately).
644   - Building libltdl with a C++ compiler has been undusted.
645   - On (AIX?,) HP-UX, and OpenBSD, hardcoding has been changed to prefer
646     rpath over absolute dependent library names.  This fixes DESTDIR
647     installs, among others, on the non-HP-UX/PA systems.
648   - Use of C++ templates together with shared libraries has been
649     improved on some systems and with some compilers, but is still
650     ongoing work.  Feedback is desirable here.
652 * Bug fixes:
654   - Fix libltdl on static platforms.
655   - Search paths with GCC on multilib systems like x86_64 have been fixed.
656   - Fixed a regression that prevented use of libltdl without autotools.
657   - Fix error with -version-info on systems with version_type=none, such
658     as BeOS.
659   - Fix symbol exporting for cases where command line length limits are
660     exceeded.
661   - Improve linking with C++ libraries on Solaris with Sun compiler.
662   - Fix installation of libraries that are required by installation
663     commands such as 'ln' or 'rm'.
664   - More robust parsing of mangled '.la' files inside libltdl, fixing a
665     possible overrun and a crash due to memory exhaustion.
666   - Fix compile command line for gcj on MinGW.
667   - Some configure variables have been renamed to fix caching:
668     lt_prog_compiler_pic_works to lt_cv_prog_compiler_pic_works
669     lt_prog_compiler_static_works to lt_cv_prog_compiler_static_works.
670   - Fix 1.9b regression: lt_dlopen(NULL) works on AIX again.
671   - Loads of smaller bug fixes.
674 New in 1.9f: 2004-10-23; CVS version 1.9e, Libtool team:
675 * Fix a regression in 1.9d, where ECHO was always set to 'echo' and the
676   backslash quoting tests were never run.
677 * Fix a regression in 1.9d, where progpath was used for --no-reexec before it
678   was set.
679 * Fix a regression in 1.9d, which required an installed automake to build the
680   bootstrapped tarball.
681 * Fix hanging bug on MinGW.
683 New in 1.9d: 2004-10-03; CVS version 1.9c, Libtool team:
684 * If non-pic objects were not compiled, and libtool is called in link mode,
685   libtool no longer silently creates an empty archive, but rather falls
686   back to pic objects.
687 * When compiling C glue code with $LTCC, libtool now saves the setting of
688   $compiler_flags from the C tag, and passes those flags to $LTCC.
689 * libtool no longer dies when concurrently creating directories with
690   'make -j' on multi-processor hosts.
691 * Return type, and name parameter of lt_dlloader_remove are no longer
692   'const'.
693 * Name parameter of lt_dlloader_find is no longer 'const'.
694 * The API for the slist ADT has been updated: slist_new has been replaced
695   by slist_box; slist_unbox and slist_sort are new; the footprint of
696   slist_remove and slist_fnid have changed; SListCallback and SListCompare
697   types have been exchanged.  See libltdl/slist.c for documentation.
698 * libltdl is C89 compatible again.  lt_dlsymbol type removed, and lt_dlsymlist
699   structure changed to avoid using C99 flexible arrays.
700 * Support self dlopening for executables on cygwin and mingw.
701 * Improved support for linux-gnu/ia64.
702 * Initial support for s390x-ibm-tpf.
703 * Fixed some memory leaks in libltdl.
704 * Improved support for OpenBSD (use rpath instead of hardcoding absolute
705   file names).
707 New in 1.9b: 2004-08-29; CVS version 1.5a, Libtool team:
708 * The /^_?LT_[A-Z_]+$/ namespace is now reserved for Libtool's own macros.
709   If you have any shell variables in this namespace they will need to be
710   renamed.  If you have any macros in this namespace please rename them to
711   prevent any possible future clash with libtool supplied macros.
712 * New LT_PREREQ macro for specifying minimum libtool requirement.
713 * New LT_INIT interface replaces AC_PROG_LIBTOOL, AC_ENABLE_SHARED,
714   AC_DISABLE_SHARED, AC_ENABLE_STATIC, AC_DISABLE_STATIC,
715   AC_ENABLE_FAST_INSTALL, AC_DISABLE_FAST_INSTALL, AC_LIBTOOL_DLOPEN,
716   AC_LIBTOOL_WIN32_DLL and AC_LIBTOOL_PIC_MODE.  Use autoupdate to modernise
717   your configure.ac files after installing this release.
718 * New LT_LANG interface to enable libtool support for a specific language.
719 * Language support is now only included if your configure.ac enables it,
720   either through a call to AC_PROG_CXX etc. or LT_LANG.
721 * The libtool script will complain if it was built from mismatched ltmain.sh
722   and libtool m4 macro versions.
723 * Like automake, libtoolize no longer installs config.guess and config.sub by
724   default.  Use new --install option to get the old behaviour.
725 * libtoolize no longer supports the --ltdl-tar option.
726 * libtool script is now created by config.status.  Instead of interrogating
727   './libtool' from configure.ac after calling AC_PROG_LIBTOOL, use the
728   variable names directly.
729 * libltdl is no longer a self-contained package, and shares configury with
730   the top level directory now.
731 * Shared objects (.lo) are no longer created when '-static' is passed in
732   compile mode.
733 * New compile mode option '-shared' prevents creation of static objects (.o).
734 * New link mode option '-shared' creates only shared libraries at link time.
735 * If you configure libtool with --disable-shared (or if libtool does not
736   support shared libraries on your platform) trying to build a library using
737   '-shared' is a fatal error.
738 * New link mode option '-weak' tells libtool when not to propagate dependency
739   libraries from dlpreopened modules.
740 * libtoolize installs libtool.m4, (ltdl.m4 if used,) and various supporting
741   m4 definitions to AC_CONFIG_MACRO_DIR.
742 * Mode inference removed, shorthand for choosing modes added.
743 * Specifying -allow-undefined is now an error.
744 * Speed up max_cmd_len check.
745 * libltdl can now preopen modules from within a library, and libtool will
746   accept -dlpreopen options when linking either a shared library or a
747   convenience library.
748 * New function in libltdl: lt_dlhandle_find provides access to module handles
749   by module name.
750 * New function in libltdl: lt_dlpreload_open opens all preloaded modules.
751 * libltdl no longer loads shared libraries with global symbol resolution,
752   this caused problems when the symbols were intended to be overridden further
753   up the stack; it is also not recommended practice.
754 * New function in libltdl: lt_dlhandle_first, primes handle iterations (using
755   lt_dlhandle_next) to filter by module interface.
756 * libltdl no longer tries to support multi-threaded programming with
757   lt_dlmutex_register(), which was unusable with POSIX threads anyway.
758   The symbols are deprecated but exported for backwards compatibility.
759 * libltdl no longer uses lt_dlmalloc, lt_dlrealloc and lt_dlfree.  The symbols
760   are still exported for backwards compatibility.
761 * The lt_dlinfo struct has a new module field that can be used by dlloaders.
762 * libltdl no longer supports pre-c89 compilers.  Some of the pre89 portability
763   functions had compile time bugs in them anyway, so you guys can't have been
764   using it :-)
765 * make install now deletes preexisting $prefix/share/libtool before installing
766   latest files.
767 * Extracting symbols from an import library on cygwin and win32 now works.
768 * Initial support for amigaos-ppc.
769 * Improved support for OpenBSD.
770 * Support for Intel C++ version 8.0.
771 * New support for IBM's xlc and xlc++ on Mac OS X.
772 * Finished support for QNX RTOS.
773 * Bug fixes.
775 New in 1.5.8: 2004-08-07; CVS version 1.5.7a, Libtool team:
776 * Support for Intel C++ version 8.0.
777 * Improved support for OpenBSD.
778 * Support for xlc on Mac OS X.
779 * Better support for zsh as /bin/sh.
780 * Much faster check for command line length on all BSD systems.
781 * Better Mac OS X/darwin support.
782 * Bug Fixes.
784 New in 1.5.6: 2004-04-11; CVS version 1.5.5a, Libtool team:
785 * Installs libltdl files properly in $prefix/share/libtool/libltdl. 1.5.4
786   did not install them at all.
787 * libltdl correctly guesses the extension for loadable modules again.
789 New in 1.5.4: 2004-04-03; CVS version 1.5.3a, Libtool team:
790 * Bug fixes.
792 New in 1.5.2: 2004-01-25; CVS version 1.5.0a, Libtool team:
793 * lt_dlrealloc is an official part of the libltdl API.
794 * --tag, --silent and --debug options are preserved and reused when libtool
795   calls itself for relinking etc.
796 * '-pthread' and similar options are honoured when linking shared libraries.
797 * -no-suppress in compile mode shows compiler output for both PIC and non-PIC
798   object compilation.
799 * New link mode option '-precious-files-regex' to prevent accidental removal
800   of files you want to keep, such as test coverage data, from the temporary
801   output directory.
802 * Directories specified in /etc/ld.so.conf are no longer hardcoded on GNU/Linux.
803 * Recognises the 'R' symbol type on Solaris so read-only symbols can be
804   exported.
805 * Bug fixes.
807 New in 1.5.1: 2003-??-??; CVS version 1.5.0a, Libtool team:
808 * lt_dlrealloc is an official part of the libltdl API.
809 * Bug fixes.
811 New in 1.5: 2003-04-14; CVS version 1.4e, Libtool team:
812 * First stable release of multi-language architecture.
813 * libtool and libltdl support for Mac OS/X.
814 * libltdl will now use cygwins dlopen API instead of always forcing
815   LoadLibrary.
816 * Support auto-import patch to binutils on cygwin for much improved dll
817   support.
818 * Bug fixes.
820 New in 1.4.3: 2002-10-13; CVS version 1.4.2a, Robert Boehne:
821 * The libltdl subdirectory now bootstraps correctly with Automake 1.5.
822 * srcdir != builddir builds with Automake 1.5 work correctly.
823 * Support for mips-compaq-nonstopux.
824 * New command line argument, --preserve-dup-deps prevents removal of
825   duplicate dependent libraries.
827 New in 1.4d: 2002-01-07; CVS version 1.4c, Libtool team:
828 * Help strings display correctly again.
829 * Better error messages when library linking fails.
830 * Better error messages from libltdl when loading fails.
831 * Better search path management in libltdl with 'lt_dlinsertsearchdir' call.
832 * Support /lib/w32api in recent cygwin releases.
833 * Support cross compilation to mingw.
834 * Support for .rc files (Windows resource compiler).
835 * Improved handling of mingw gcc.
836 * Improved handling of $PATH with entries containing spaces.
837 * Improved support for linking with gcc on aix4* and aix5*.
838 * Improved support for GCC 3.0.
839 * Initial support for QNX RTOS, UnixWare 7 and OpenUNIX 8.
840 * Bug fixes to the OpenBSD port.
841 * Bug fixes.
843 New in 1.4.2: 2001-09-11; CVS version 1.4.1a, Gary V. Vaughan:
844 * libltdl now builds on solaris again
845 * diagnose and warn about not-quite-working combinations of gcc and
846   ld on solaris.
847 * Improved OpenBSD support.
848 * Improved cygwin support.
849 * Bugfixes.
851 New in 1.4.1: 2001-09-03; CVS version 1.4.0a, Libtool team:
852 * Better error messages from libltdl when loading fails.
853 * Don't leave here-doc files behind.
854 * Improved support for OpenBSD.
855 * Libtool will build with autoconf-2.50 and higher.
856 * Plug memory management bugs in libltdl.
857 * Prefer shl_load to dlopen for better operation on HP-UX.
859 New in 1.4b: 2001-07-09; CVS version 1.4a, Libtool team:
860 * Now bootstraps with autoconf-2.50 and automake-1.4-p4.
861 * Always try to build at least a static lib, even if both static and
862   shared libs were disabled.
863 * Full support for C++ compiler.
864 * Support for GNU gcj compiler.
865 * libltdl can now load all modules in a given path according to user
866   supplied criteria with 'lt_dlforeachfile' call.
867 * Improved support for AIX ia64, djgpp, HPUX, hurd, OpenBSD, sco3.2*.
868 * Internal mutex handling no longer has namespace clashes on NCR MP-RAS.
869 * New pdemo and tagdemo tests.
870 * Bug fixes.
872 New in 1.4: 2001-04-25; CVS version 1.3e, Libtool team:
873 * Support for aix5*.
874 * Bugfixes.
876 New in 1.3d: 2001-04-02; CVS version 1.3c, Libtool team:
877 * ltconfig is no more.  Generation of libtool happens directly from
878   the configure file.
879 * Multithread safe with lt_dlmutex_register callback registration.
880 * New -no-install flag to avoid the use of executable wrapper scripts.
881 * New --with-pic, -prefer-pic and -prefer-non-pic flags to control
882   the generation of PIC/non-PIC code.
883 * Support for hardcoding run-time paths (-R) into libraries.
884 * Support -dlopen and -dlpreopen for libraries.
885 * Libtool now allows you to link shared libraries against static code.
886 * New functions in libltdl:
887   lt_dlgetinfo, lt_dlhandle_next and lt_dlforeach provide access to module
888   specific data in handles.
889   lt_dlcaller_register, lt_dlcaller_set_data and lt_dlcaller_get_data provide
890   management for user storage of per module data.
891   lt_dlloader_next, lt_dlloader_name, lt_dlloader_find, lt_dlloader_add and
892   lt_dlloader_remove can be used for adding new types of module loaders.
893   lt_dladderror, lt_dlseterror integrate user module loaders with lt_dlerror.
894 * "-Xcompiler" and "-Wc," does now work in compile mode, too.
895 * Support recent dlltool formats.
896 * Start of support code for cross-compiling to win32.
897 * libltdl can now be built as a dll with win32.
898 * m4 macros needed to configure libltdl split out into libltdl/ltdl.m4.
899 * New port to NEWS-OS Release 6.
900 * Improved support for darwin (rhapsody), mingw32, NetBSD, Compaq Tru64 V5.0
901   and Digital Unix V4.*.
902 * Initial support for ia64 linux.
903 * Initial support for a.out freebsd shared libs.
904 * Initial support for Paul Sokolovsky's pw32 POSIX over win32 layer.
905 * Many bugfixes (especially in libltdl)
907 New in 1.3b: 1999-07-02; CVS version 1.3a, Libtool team:
908 * Complete inter-library dependencies support. It's now possible
909   to link libtool libraries against other libtool libraries.
910 * Libtool is able to find already-installed libtool libraries,
911   even if they were moved out of their installation directory.
912 * New "-Wc,flag" and "-Xcompiler flag" flags to pass flags
913   directly to the compiler
914 * New "-Wl,flag" and "-Xlinker flag" flags to pass flags
915   directly to the linker
916 * New "-no-fast-install" flag to selectively disable fast-install mode.
917 * Support for installing stripped libraries using GNU strip (install -s).
918   Automake >= 1.5 will install stripped libraries with "make install-strip".
919 * Allow linking shared libraries against static ones
920   on FreeBSD, GNU/Linux, GNU Hurd and Solaris
921 * Support for linking DLLs on Win32
922 * New 'clean' mode to delete uninstalled files.
923 * New demos and tests
924 * Various bugfixes
926 New in 1.3.5: 2000-05-27, CVS version 1.3.4a, Libtool team:
927 * Support for mac OS X (rhapsody).
928 * Support for *-sequent-sysv4.
929 * Support for Cygwin-1.1.0.
930 * Support recent dlltool formats.
931 * Bugfixes.
933 New in 1.3.4: 1999-12-08, CVS version 1.3.3a, Libtool team:
934 * Support for Compaq Tru64 V5.0.
935 * Improved support for Digital Unix V4.*.
936 * Improved support for NetBSD, FreeBSD and Unixware.
937 * Many fine bugfixes.
939 New in 1.3.3: 1999-07-02, CVS version 1.3.2a, Libtool team:
940 * New '-dlpreopen force' flag to ensure that
941   lt_preloaded_symbols is always defined.
942 * Work around self-dlclose bug in FreeBSD 3.1.
943 * Expand convenience libraries when creating reloadable objects.
944 * Do not forget to import -L flags of convenience libraries.
945 * Do not pass -whole-archive or equivalent to symbol extractor.
946 * Create directory to expand convenience libraries only when needed.
947 * Improved support for Cygwin, DJGPP and NetBSD
948 * Various bugfixes
950 New in 1.3.2: 1999-05-26, CVS version 1.3.1a, Libtool team:
951 * Avoid circular links of objects and libraries.
952 * Look for dlerror when dlopen was found in -ldl (typo).
953 * Disable shared libraries with broken GNU ld on Solaris.
955 New in 1.3.1: 1999-05-21, CVS version 1.3.0a, Libtool team:
956 * Documentation improvements; recommend automake users to insert libtool.m4
957   in acinclude.m4
958 * AC_LIBLTDL_CONVENIENCE and AC_LIBLTDL_INSTALLABLE now set INCLTDL.
959 * New port to NEC UX/4800.
960 * cygwin-b20.1 passes all tests.
961 * Slightly improved BeOS support.
962 * Many AIX 4.3.2 test failures have gone.
963 * Pass unknown -L arguments through to the linker (for -LANG:* support).
964 * Close a security hole with mode 777 directory during libltdl installation.
965 * Fixed the infamous 'ifelse' bug in libtool.m4
967 New in 1.3: 1999-04-29, Libtool team:
968 * This is just a summary of the changes since 1.2.
969   See the news of intermediate alpha releases below for details.
970 * Support for convenience archives.
971 * New maintainers.  Anonymous CVS and home page at gnu.org.
972 * Portable dlopening interface with libltdl, new -module flag.
973 * Correctly link installed libtool libraries into programs and other
974   libtool libraries.  Linking of uninstalled libtool libraries into
975   libraries is under development for 1.4.
976 * Do not drop library dependencies on platforms that allow them.
977 * Linking with uninstalled libraries no longer picks installed ones by
978   mistake.
979 * Use libraries from the build tree when running uninstalled
980   executables (may require double linking).
981 * Allow developers to optimize for build-tree executions.
982 * Support -export-symbols-regex for controlled symbol exporting.
983 * Support -R to hardcode directories in library search paths.
984 * New ports, demos and tests.  Lots of improvements and bug fixes.
986 New in CVS version 1.2g, Libtool team:
987 * AM_PROG_LIBTOOL is smaller and faster
988 * AC_LIBTL_L_WIN32_DLL is required in configure.in for libtool to
989   attempt to build dlls on win32 hosts
990 * Shared libraries on AmigaOS up to version 4 are now disabled
991   since they don't meet libtool's requirements for shared libraries
992 * -L supports now relative directories
993 * Libltdl has a new license: LGPL with a special exception
994 * Libltdl can be used as stand-alone package
995 * dlopen support for BeOS
996 * Partial support for Motorola System V 4
997 * Improved support for AIX, BeOS, Cygwin, DJGPP, DU, IRIX and HP/UX
998 * Documentation updates
999 * New tests
1000 * Bugfixes
1002 New in 1.2f: 1999-03-15; CVS version 1.2e, Libtool team:
1003 * libtool will correctly link uninstalled libraries into programs
1004   and prefer uninstalled libraries to installed ones
1005 * Library paths that are in the system default run-time search path
1006   are no longer hardcoded into executables.
1007 * New fast installation mode, which links the final executable
1008   in order to avoid relinking during installation.
1009   Programs in the build-tree are relinked when executed.
1010 * New AC_DISABLE_FAST_INSTALL macro to set the default for
1011   the fast-install mode to disabled
1012 * New -export-symbols-regex flag, to export symbols selectively by
1013   a regular expression
1014 * Support -R for specifying run-time path of programs and library dependencies
1015 * New -avoid-version option to avoid versioning for libraries
1016 * libtool module names no longer need to have a "lib" prefix
1017   (requires automake 1.4).
1018 * New -thread-safe flag, to build thread-safe libraries
1019 * Major improvements in libltdl: API documentation, installable version,
1020   support for module search paths, support for lt_dlopen(0),
1021   can be embedded into packages as a tar file (libltdl.tar.gz),
1022   dynamic buffer allocation and buffer overflow checks,
1023   new macro LTDL_SET_PRELOADED_SYMBOLS() which must be used in the
1024   main program, dynamic memory allocation functions are user-defineable
1025 * New AC_LIBLTDL_CONVENIENCE and AC_LIBLTDL_INSTALLABLE macros, to select
1026   convenience and/or installable versions of libltdl.
1027 * libltdl is now built and installed unless --disable-ltdl-install
1028 * New "-dlopen self" flag for dlopening the executable itself
1029 * New AC_LIBTOOL_DLOPEN macro to check for dlopen support,
1030   required if you use -dlopen or -dlpreopen
1031 * If libtool could not satisfy all dependencies of a module
1032   it will only build a static version of it
1033 * dld_preloaded_symbols was renamed to lt_preloaded_symbols
1034 * Support for BeOS
1035 * Improved support for FreeBSD, AIX, IRIX, OSF, SysV 4.3, HP/UX, DJGPP
1036   BSD/OS 4.x and NetBSD
1037 * In order for libtool to attempt to link a shared library (dll) on win32
1038   platforms, you must pass the -no-undefined flag to libtool in link mode.
1039 * The path to GNU ld now works on cygwin-b18 to cygwin-b20.2 at least.
1040 * Support for IRIX library versioning.
1041 * New demos and tests
1042 * Various bugfixes
1044 New in 1.2d: 1998-12-16; CVS version 1.2c, Libtool team:
1045 * libtool will correctly link already-installed libraries into programs.
1046 * New -module flag, to create loadable modules.
1047 * New libltdl, a small library for portable dlopening of modules.
1048   It is still undocumented, but you can already find some examples in:
1049 * New mdemo directory, with tests of -module and dlopening examples.
1050   Be aware that libltdl is only known to work on a few platforms such as
1051   GNU/Linux and Solaris2.  Some mdemo tests are known to FAIL on several
1052   other platforms; please ignore these failures by now (or work to fix
1053   them :-).
1054 * Inter-library dependencies patch finally integrated, but there's
1055   still much porting to do.  See PORTING for details (some plans for the
1056   future in mail/deplibs in the CVS tree).
1057 * New option -export-symbols to control symbol exporting when possible.
1058 * Fixed -export-dynamic problem with C++ programs in egcs 1.1.
1059 * New dlpreopen structure.
1060 * libtool now supports '-c -o' and subdirectories in sources and
1061   target object names even in platforms whose compilers do not support
1062   this.  In this case, file locking occurs to avoid problems with
1063   parallel builds.
1064 * New 'echo' variant that should fix most problems with long command
1065   lines and broken printf programs.
1066 * Support for DG/UX, UnixWare 7.x and FreeBSD 3.0, and improved
1067   support for Microsoft Windows
1068 * Various bugfixes
1069 * We now have anonymous CVS access to GNU libtool.  CVSROOT is
1070   :pserver:anoncvs@anoncvs.gnu.org:/gd/gnu/anoncvsroot.  The password
1071   is empty.  The directory is libtool.  Check our home-page at
1072   https://www.gnu.org/software/libtool/libtool.html for details.
1073 * Alexandre Oliva, Thomas Tanner and Gary V. Vaughan have taken over
1074   the maintenance of libtool.
1075 * Arguments to ltconfig have been changed to allow creation of a
1076   libtool C program, totally unusable as of this release.
1078 New in 1.2b - 1998-07-01, Gordon Matzigkeit:
1079 * Libtool needs a new maintainer, since Gordon Matzigkeit has quit.
1080   If you think you can do the job, send mail to bug-libtool@gnu.org.
1081 * Bug fixes.
1082 * Support for libtool convenience archives.
1084 New in 1.2a - 1998-04-19, Gordon Matzigkeit:
1085 * Bug fixes.
1086 * ltconfig accepts an '--output' option to specify the name of the
1087   generated libtool.
1088 * New '--debug' flag to turn on shell script tracing for libtool,
1089   libtoolize, and ltconfig.
1090 * Added 'libtool --config' to print out all configuration variables.
1091 * Support for *-*-hpux11*.
1093 New in 1.2 - 1998-03-20, Gordon Matzigkeit:
1094 * Minor bug fixes to provide a stable public release.
1095 * Libtool no longer cseses Solaris printf to barf due to silly
1096   2110-byte static buffers.
1098 New in 1.1 - 1998-03-08, Gordon Matzigkeit:
1099 * Bug fixes.
1100 * http://www.profitpress.com/libtool/ is libtool's homepage.
1101 * 'AM_PROG_LIBTOOL' supports turning shared or static libraries off
1102   with the '--enable-shared=PKGS' and '--enable-static=PKGS' configure
1103   flags.  See (libtool)AM_PROG_LIBTOOL.
1104 * Use the 'AM_DISABLE_SHARED' or 'AM_DISABLE_STATIC' macros if you
1105   wish to modify the default behaviour of 'AM_PROG_LIBTOOL' for your
1106   package.
1107 * New rules for 'AM_PROG_LD' to use gcc's '-print-prog-name' flag in
1108   order to find ld, if possible.
1109 * Suppress duplicate compiler output during 'compile' mode.
1110 * Deleted 'dlname' mode.  Dlopen applications should only use the
1111   runtime search method described in (libtool)Finding the dlname.
1112 * Experimental support for dynamically loaded modules, even on
1113   static-only platforms, via new '-dlopen' and '-dlpreopen' link
1114   flags.
1115 * 'compile' mode honours the '-static' flag to prevent libtool
1116   from building PIC objects.
1117 * New 'execute' mode to support debugging uninstalled libtool
1118   libraries and executables.
1119 * '-allow-undefined' is now the default.  You can use '-no-undefined'
1120   to declare that a shared library is completely self-contained.
1121 * Inter-library dependencies are automatically handled when linking
1122   against an uninstalled '.la' file.
1123 * New '-all-static' flag to prevent any dynamic linking.  The regular
1124   '-static' flag now just prevents dynamic linking of libtool libraries.
1125 * New '-release' flag to encode release numbers into libtool
1126   libraries.  This breaks binary compatibility, but is useful for
1127   libraries whose interfaces change very frequently.  See
1128   (libtool)Versioning.
1129 * The '-rpath' flag can be used to hardcode absolute directories when
1130   linking executables using libtool.
1131 * New robust quoting code to handle any metacharacters passed in
1132   arguments to libtool commands.
1133 * Full support for broken collect2 on AIX 3.  Shared libraries
1134   can now be built with all working versions of GCC on AIX.
1135 * Shell script speed optimizations for old and buggy /bin/sh systems,
1136   such as HP-UX 9 and SunOS 4.1.4.
1137 * Maybe use '_libs' as a temporary libtool directory instead of '.libs'
1138   in order to cope with MS-DOS filenames.
1139 * Portability fixes for Windows NT.
1140 * Refuse to create libtool libraries that don't begin with 'lib'.
1141   This allows us to correctly handle OSes that don't have the 'lib'
1142   prefix by default, such as OS/2.
1143 * Support for *-*-amigaos*, *-*-os2*, *-*-sysv4.2uw2*, and *-*-uts4*.
1145 New in 1.0 - 1997-07-08, Gordon Matzigkeit:
1146 * Bug fixes.
1147 * Better configuration test to find the system linker.  The old test
1148   was failing because people frequently install GNU ld, but don't
1149   necessarily configure GCC to use it.
1150 * Automake support for Libtool now uses the LTLIBRARIES primary.  See
1151   the Automake documentation for more information.
1152 * Added new '--disable-static' flag to disable building static
1153   libraries on platforms that have shared libs.
1154 * New '-allow-undefined' link flag to build shared libs that contain
1155   references to unresolved symbols.
1156 * Removed all support for creating static-only libraries.
1157 * Basic support for dynamically loaded modules: new '-export-dynamic'
1158   linking flag and corresponding 'dlname' mode.
1159 * New '--features' flag to display configured libtool attributes.
1160 * Added support for installing libtool objects, both in absolute and
1161   relative directories.
1162 * Support *-*-linux-gnu* as an alias for *-*-linux*.
1163 * Support for *-*-openbsd* and *-*-freebsd3*.
1165 New in 0.9 - 1997-02-03, Gordon Matzigkeit:
1166 * Bug fixes.
1167 * The libtool demo now uses the libm cos(3) function, to demonstrate
1168   inter-library dependencies.
1169 * The PLATFORMS file has been moved to doc/platforms.texi.
1171 New in 0.8 - 1997-01-26, Gordon Matzigkeit:
1172 * Bug fixes, and more documentation.
1173 * Basic support for other language compilers (C++, Fortran, and
1174   preprocessed assembler).
1175 * Libtool is now more persistent when linking with the '-static'
1176   flag fails.
1177 * New test for hardcoding system linkers, to verify that libtool
1178   neither creates incorrect binaries, nor takes unnecessary
1179   precautions while linking against uninstalled shared libraries.
1180 * For clarity, the demo subdirectory no longer uses ansi2knr, and has
1181   been rewritten to avoid ANSI-only constructs.
1182 * Support for *-*-irix5, *-*-irix6*, and *-*-sco3.2v5*.
1184 New in 0.7 - 1996-12-08, Gordon Matzigkeit:
1185 * Total rewrite of libtool, along with a new model for library building.
1186 * Completely rewritten documentation for the new paradigm.
1187 * Sane handling of broken system linkers, such as the ones on AIX
1188   and HP-UX.
1189 * configure mode is now a separate program, 'ltconfig'
1190 * The libinfo helper script has been incorporated into the main
1191   libtool program.
1192 * Automatic mode guessing, based on the command line.
1193 * Full support for Automake 1.2 (including ansi2knr features).
1194 * Support to create reloadable objects using link mode.
1195 * Support for new '-static' linking flag.
1196 * Support for stripping libraries during installation.
1197 * Library version information is now passed on the command line, not
1198   through a version file.
1200 Version 0.6 was never released.
1202 New in 0.5:
1203 * Disabled install-progs until next version, when it will be correctly
1204   implemented.
1205 * Clearer library versioning documentation.  See (libtool)Versioning.
1206 * Renamed gm_PROG_LIBTOOL to AM_PROG_LIBTOOL
1207 * Libtool now creates pseudo-objects named foo.lo and pseudo-archives named
1208   libfoo.la instead of foo.o and libfoo.a.  See the documentation.
1209 * libtool compile doesn't interfere with user CFLAGS if they don't
1210   conflict with the current objtype.  From Karl Berry.
1211 * Created new libinfo helper script.
1212 * libversion.in files are obsolete -- libtool uses libinfo to read the
1213   new LIBINFO files.
1214 * Libtool is better at finding its config file and helper scripts.
1215 * Support for *-*-gnu*
1217 New in 0.4:
1218 * Bug fixes and new regression tests
1219 * On unsupported configurations, 'libtool configure' demotes OBJTYPES to
1220   'standard' instead of aborting
1221 * Added new object type, 't', for tcov(1) support
1222 * Support for *-*-aix3*, *-*-aix4*, *-*-hpux10*, *-*-osf3*, and *-*-solaris2*
1224 New in 0.3:
1225 * Bug fixes and new regression tests
1226 * Added new uninstall-libs mode
1227 * Added a host argument to configure mode
1228 * Fixed debugging/hyper-optimizing flags conflict (from Karl Berry)
1229 * Support for --no-whole-archive when needed by GNU ld (from Ulrich Drepper)
1230 * Implementation of --enable-linktype, --enable-profile, --enable-shared,
1231   --enable-static in gm_PROG_LIBTOOL macro
1232 * New 'libtoolize' program (modeled after GNU gettext's 'gettextize') to help
1233   conversion to libtool
1234 * New ABOUT-LIBS document for inclusion with libtool-supported packages
1236 New in 0.2:
1237 * Support for *-*-linux
1238 * Better checking for GNU ld
1239 * Reimplemented the config file so that it corresponds more closely to the
1240   variables listed in (libtool)Porting Libtool.
1241 * Reimplemented the shared library version scheme.  See (libtool)Versioning.
1242 * Replaced '--config-file' and '--version-file' options with '--confdir'
1243 * Added new install-libs and install-progs modes
1245 New in 0.1:
1246 * First release of libtool
1247 * Support for: *-*-freebsd*, *-*-netbsd*, *-*-sunos4*, *-*-ultrix4*
1248 -- 
1250 Copyright (C) 1996, 1998-2019, 2021-2024 Free Software Foundation, Inc.
1252 This file is part of GNU Libtool.
1254 Copying and distribution of this file, with or without modification,
1255 are permitted in any medium without royalty provided the copyright
1256 notice and this notice are preserved.  This file is offered as-is,
1257 without warranty of any kind.