From 114283d84f0291a4da75e900fd188a2d5e9af586 Mon Sep 17 00:00:00 2001 From: Nick Clifton Date: Wed, 31 Oct 2001 14:19:22 +0000 Subject: [PATCH] Update documentation about -T augmenting linker scripts --- ld/ChangeLog | 7 +++++++ ld/ld.texinfo | 18 +++++++----------- 2 files changed, 14 insertions(+), 11 deletions(-) diff --git a/ld/ChangeLog b/ld/ChangeLog index 5758230e8c..c246d7a6a0 100644 --- a/ld/ChangeLog +++ b/ld/ChangeLog @@ -1,3 +1,10 @@ +2001-10-31 John Marshall + + * ld.texinfo: A historical requirement that MEMORY and SECTIONS + appear only once across all the linker scripts involved in a link + invocation no longer applies. Make the documentation reflect + that. + 2001-10-31 NIIBE Yutaka * configure.tgt: Supports sh3/sh4/sh3eb/sh4eb-unknown-linux-gnu diff --git a/ld/ld.texinfo b/ld/ld.texinfo index 74e0b8711e..09a03db548 100644 --- a/ld/ld.texinfo +++ b/ld/ld.texinfo @@ -98,7 +98,7 @@ notice identical to this one except for the removal of this paragraph @vskip 0pt plus 1filll @c man begin COPYRIGHT -Copyright @copyright{} 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000 Free Software Foundation, Inc. +Copyright @copyright{} 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 @@ -277,10 +277,8 @@ linker script or the one specified by using @samp{-T}). This feature permits the linker to link against a file which appears to be an object or an archive, but actually merely defines some symbol values, or uses @code{INPUT} or @code{GROUP} to load other objects. Note that -specifying a script in this way should only be used to augment the main -linker script; if you want to use some command that logically can only -appear once, such as the @code{SECTIONS} or @code{MEMORY} command, you -must replace the default linker script using the @samp{-T} option. +specifying a script in this way merely augments the main linker script; +use the @samp{-T} option to replace the default linker script entirely. @xref{Scripts}. For options whose names are a single letter, @@ -754,12 +752,10 @@ Print the names of the input files as @code{ld} processes them. Use @var{scriptfile} as the linker script. This script replaces @code{ld}'s default linker script (rather than adding to it), so @var{commandfile} must specify everything necessary to describe the -output file. You must use this option if you want to use a command -which can only appear once in a linker script, such as the -@code{SECTIONS} or @code{MEMORY} command. @xref{Scripts}. If -@var{scriptfile} does not exist in the current directory, @code{ld} -looks for it in the directories specified by any preceding @samp{-L} -options. Multiple @samp{-T} options accumulate. +output file. @xref{Scripts}. If @var{scriptfile} does not exist in +the current directory, @code{ld} looks for it in the directories +specified by any preceding @samp{-L} options. Multiple @samp{-T} +options accumulate. @kindex -u @var{symbol} @kindex --undefined=@var{symbol} -- 2.34.1