From: DJ Delorie <dj@redhat.com>
Date: Tue, 12 Dec 2000 22:37:20 +0000 (+0000)
Subject: * ld.texinfo: Add notes about --whole-archive and gcc.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=7ec229cebec3e99e605b67bbffdd32b90e4fd5f9;p=binutils-gdb.git

* ld.texinfo: Add notes about --whole-archive and gcc.
---

diff --git a/ld/ChangeLog b/ld/ChangeLog
index e1ad2771000..87d8c469e7c 100644
--- a/ld/ChangeLog
+++ b/ld/ChangeLog
@@ -1,3 +1,7 @@
+2000-12-11  DJ Delorie  <dj@redhat.com>
+
+	* ld.texinfo: Add notes about --whole-archive and gcc.
+
 2000-11-18  Fred Fish  <fnf@be.com>
 
 	* lexsup.c (OPTION_ALLOW_SHLIB_UNDEFINED): Define.
diff --git a/ld/ld.texinfo b/ld/ld.texinfo
index b7a64e995a7..aadfc05d656 100644
--- a/ld/ld.texinfo
+++ b/ld/ld.texinfo
@@ -1368,6 +1368,12 @@ files.  This is normally used to turn an archive file into a shared
 library, forcing every object to be included in the resulting shared
 library.  This option may be used more than once.
 
+Two notes when using this option from gcc: First, gcc doesn't know
+about this option, so you have to use @code{-Wl,-whole-archive}.
+Second, don't forget to use @code{-Wl,-no-whole-archive} after your
+list of archives, because gcc will add its own list of archives to
+your link and you may not want this flag to affect those as well.
+
 @kindex --wrap
 @item --wrap @var{symbol}
 Use a wrapper function for @var{symbol}.  Any undefined reference to