From: Bruno Haible <bruno@clisp.org>
Date: Mon, 2 Sep 2024 09:33:27 +0000 (+0200)
Subject: Document situations where -export-symbols does not work.
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=ff39c3238c026b45ad027ccbf513fc44a5c5c0bd;p=thirdparty%2Flibtool.git

Document situations where -export-symbols does not work.

* doc/libtool.texi (Link mode): Document that -export-symbols does not work on
static libraries. Document the most important platforms where it does not work
on shared libraries.
---

diff --git a/doc/libtool.texi b/doc/libtool.texi
index 04ab34f1f..503c0fb1b 100644
--- a/doc/libtool.texi
+++ b/doc/libtool.texi
@@ -1491,7 +1491,13 @@ Allow symbols from @var{output-file} to be resolved with @code{dlsym}
 @item -export-symbols @var{symfile}
 Tells the linker to export only the symbols listed in @var{symfile}.
 The symbol file should end in @file{.sym} and must contain the name of one
-symbol per line.  This option has no effect on some platforms.
+symbol per line.  This option has no effect:
+@itemize @bullet
+@item
+on static libraries, and
+@item
+on shared libraries on some platforms, such as AIX and Haiku.
+@end itemize
 By default all symbols are exported.
 
 @item -export-symbols-regex @var{regex}