diff options
author | Simon Josefsson <simon@josefsson.org> | 2010-10-09 12:26:16 +0200 |
---|---|---|
committer | Ralf Wildenhues <Ralf.Wildenhues@gmx.de> | 2010-10-12 07:36:46 +0200 |
commit | 72266fced994c7efe609b52c889f5241aebda744 (patch) | |
tree | b7de430c52ffc3bdc8ed065041eea23a6855438d /doc | |
parent | 2ed5700993f997817ad5c164a4bbe4559e5bf66a (diff) | |
download | libtool-72266fced994c7efe609b52c889f5241aebda744.tar.gz |
docs: improve description of -no-undefined.
* doc/libtool.texi (Link mode): Fix -no-undefined description.
(Inter-library dependencies): Use Windows not AIX as example
system. Clarify need for symbol resolution at library creation
time.
Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/libtool.texi | 20 |
1 files changed, 12 insertions, 8 deletions
diff --git a/doc/libtool.texi b/doc/libtool.texi index cd5a1812..076b67ba 100644 --- a/doc/libtool.texi +++ b/doc/libtool.texi @@ -1517,9 +1517,12 @@ of library paths. Useful if the program is only used in the build tree, e.g., for testing or generating other files. @item -no-undefined -Declare that @var{output-file} does not depend on any other libraries. -Some platforms cannot create shared libraries that depend on other -libraries (@pxref{Inter-library dependencies}). +Declare that @var{output-file} does not depend on any libraries other +than the ones listed on the command line, i.e., after linking, it will +not have unresolved symbols. Some platforms require all symbols in +shared libraries to be resolved at library creation (@pxref{Inter-library +dependencies}), and using this parameter allows @command{libtool} to +assume that this will not happen. @item -o @var{output-file} Create @var{output-file} from the specified objects and libraries. @@ -3261,12 +3264,13 @@ in order to guarantee that all the required libraries are found. This restriction is only necessary to preserve compatibility with static library systems and simple dynamic library systems. -Some platforms, such as AIX, do not even allow you this +Some platforms, such as Windows, do not even allow you this flexibility. In order to build a shared library, it must be entirely -self-contained (that is, have references only to symbols that are found -in the @file{.lo} files or the specified @samp{-l} libraries), and you -need to specify the @option{-no-undefined} flag. By default, libtool -builds only static libraries on these kinds of platforms. +self-contained or it must have dependencies known at link time (that is, +have references only to symbols that are found in the @file{.lo} files +or the specified @samp{-l} libraries), and you need to specify the +@option{-no-undefined} flag. By default, libtool builds only static +libraries on these kinds of platforms. The simple-minded inter-library dependency tracking code of libtool releases prior to 1.2 was disabled because it was not clear when it was |