branch: master
commit 001ca1d0709257fd7e99b2ec5818a86634bb67b5
Author: Bruno Haible <br...@clisp.org>
AuthorDate: Mon Sep 2 11:33:27 2024 +0200
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.
---
doc/libtool.texi | 8 +++++++-
1 file changed, 7 insertions(+), 1 deletion(-)
diff --git a/doc/libtool.texi b/doc/libtool.texi
index 04ab34f1..503c0fb1 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}
