Remind users about -Wl,

diff --git a/ld/ChangeLog b/ld/ChangeLog
index a9e3d8c975aeb07e554f86257b4bcfac5bc48f1f..465db1be90cca0c0a000f4018fc3c91dbb9848b4 100644 (file)
--- 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 382dd7e4865cdd9faeb254f95e57d6c1f0c055fe..9b822bd92bed0c250328f3847cffc4f2a24c475f 100644 (file)
--- 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}