This is the mail archive of the
binutils@sourceware.cygnus.com
mailing list for the binutils project.
Re: Linker documentation patch
- To: binutils at sourceware dot cygnus dot com
- Subject: Re: Linker documentation patch
- From: Nick Clifton <nickc at cygnus dot com>
- Date: Fri, 7 Jan 2000 11:44:57 -0800
Hi Guys,
I have applied the following supplimental patch to my previous patch
updating the linker documentation. This patch adds a note that
other (non-GNU) compiler drivers may not use -Wl, as the linker
command line option prefix.
It also fixes a error in the documentation of the -n command line
switch. This option does not mark the text section as read-only.
(It is marked as such by default, and the -N option can be used to
make it read-write, but -n will not set it back to being
read-only). What it does do, however, is to turn off page
alignment of the sections, so I have added this to the
documentation.
Cheers
Nick
2000-01-07 Nick Clifton <nickc@cygnus.com>
* ld.texinfo (Options): Remind users to preceed linker command
line switches with -Wl, (or whatever is appropriate) if it is
being invoked by a comnpiler driver program.
Fix description of the behaviour of the -n command line switch.
Index: ld.texinfo
===================================================================
RCS file: /cvs/binutils/binutils/ld/ld.texinfo,v
retrieving revision 1.9
diff -p -r1.9 ld.texinfo
*** ld.texinfo 2000/01/07 19:06:46 1.9
--- ld.texinfo 2000/01/07 19:34:02
*************** of multiple-letter options are accepted.
*** 230,236 ****
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
--- 230,237 ----
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,} (or whatever is appropriate for the particular
! compiler driver) like this:
@smallexample
gcc -Wl,--startgroup foo.o bar.o -Wl,--endgroup
*************** which caused the archive member to be br
*** 558,565 ****
@kindex --nmagic
@item -n
@itemx --nmagic
! Set the text segment to be read only, and mark the output as
! @code{NMAGIC} if possible.
@kindex -N
@kindex --omagic
--- 559,566 ----
@kindex --nmagic
@item -n
@itemx --nmagic
! Turn off page alignment of sections, and mark the output as
! @code{NMAGIC} if possible.
@kindex -N
@kindex --omagic