diff --git a/ld/ChangeLog b/ld/ChangeLog index 7f425265a7..7055778f3e 100644 --- a/ld/ChangeLog +++ b/ld/ChangeLog @@ -1,5 +1,8 @@ Wed Jan 28 14:10:01 1998 Ian Lance Taylor + * ld.texinfo (Options): Mention LDEMULATION in description of -m. + (Environment): Mention LDEMULATION. + * ld.texinfo (Options): Clarify --export-dynamic a bit. Thu Jan 22 16:07:23 1998 Richard Henderson diff --git a/ld/ld.texinfo b/ld/ld.texinfo index f03ccf87a9..03ce443362 100644 --- a/ld/ld.texinfo +++ b/ld/ld.texinfo @@ -17,7 +17,7 @@ END-INFO-DIR-ENTRY @ifinfo This file documents the @sc{gnu} linker LD. -Copyright (C) 1991, 92, 93, 94, 95, 96, 1997 Free Software Foundation, Inc. +Copyright (C) 1991, 92, 93, 94, 95, 96, 97, 1998 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -64,7 +64,7 @@ notice identical to this one except for the removal of this paragraph @end tex @vskip 0pt plus 1filll -Copyright @copyright{} 1991, 92, 93, 94, 95, 96, 1997 Free Software Foundation, Inc. +Copyright @copyright{} 1991, 92, 93, 94, 95, 96, 97, 1998 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -490,8 +490,13 @@ at the point in which the linker script appears in the command line. @kindex -m @var{emulation} @item -m@var{emulation} Emulate the @var{emulation} linker. You can list the available -emulations with the @samp{--verbose} or @samp{-V} options. The default -depends on how your @code{ld} was configured. +emulations with the @samp{--verbose} or @samp{-V} options. + +If the @samp{-m} option is not used, the emulation is taken from the +@code{LDEMULATION} environment variable, if that is defined. + +Otherwise, the default emulation depends upon how the linker was +configured. @cindex link map @kindex -M @@ -1227,8 +1232,8 @@ call before the linker has a chance to wrap it to @code{malloc}. @node Environment @section Environment Variables -You can change the behavior of @code{ld} with the environment -variable @code{GNUTARGET}. +You can change the behavior of @code{ld} with the environment variables +@code{GNUTARGET} and @code{LDEMULATION}. @kindex GNUTARGET @cindex default input format @@ -1243,6 +1248,17 @@ there is no method of ensuring that the magic number used to specify object-file formats is unique. However, the configuration procedure for BFD on each system places the conventional format for that system first in the search-list, so ambiguities are resolved in favor of convention. + +@kindex LDEMULATION +@cindex default emulation +@cindex emulation, default +@code{LDEMULATION} determines the default emulation if you don't use the +@samp{-m} option. The emulation can affect various aspects of linker +behaviour, particularly the default linker script. You can list the +available emulations with the @samp{--verbose} or @samp{-V} options. If +the @samp{-m} option is not used, and the @code{LDEMULATION} environment +variable is not defined, the default emulation depends upon how the +linker was configured. @end ifset @node Commands