From: Nick Clifton <nickc@redhat.com>
Date: Fri, 7 Jan 2000 19:06:46 +0000 (+0000)
Subject: Remind users about -Wl,
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=4e53152f8faf67e5af38e7b8e755113ea1719124;p=binutils-gdb.git

Remind users about -Wl,
---

diff --git a/ld/ChangeLog b/ld/ChangeLog
index a9e3d8c975a..465db1be90c 100644
--- a/ld/ChangeLog
+++ b/ld/ChangeLog
@@ -1,3 +1,9 @@
+2000-01-07  Nick Clifton  <nickc@cygnus.com>
+
+	* ld.texinfo (Options): Remind users to preceed linker command
+	line switches with -Wl, if it is being invoked by a comnpiler
+	driver program.
+
 Wed Jan  5 08:02:12 2000  Catherine Moore  <clm@cygnus.com>
 
 	* ld.h (wildcard_spec):  Change exclude_name to exclude_name_list.
diff --git a/ld/ld.texinfo b/ld/ld.texinfo
index 382dd7e4865..9b822bd92be 100644
--- a/ld/ld.texinfo
+++ b/ld/ld.texinfo
@@ -228,6 +228,20 @@ requires them.  For example, @samp{--oformat srec} and
 @samp{--oformat=srec} are equivalent.  Unique abbreviations of the names
 of multiple-letter options are accepted.
 
+Note - if the linker is being invoked indirectly, via a compiler driver
+(eg @samp{gcc}) then all the linker command line options should be
+prefixed by @samp{-Wl,}  like this:
+
+@smallexample
+  gcc -Wl,--startgroup foo.o bar.o -Wl,--endgroup
+@end smallexample
+
+This is important, because otherwise the compiler driver program may
+silently drop the linker options, resulting in a bad link.
+
+Here is a table of the generic command line switches accepted by the GNU
+linker:
+
 @table @code
 @kindex -a@var{keyword}
 @item -a@var{keyword}