From: Ian Lance Taylor <ian@airs.com>
Date: Wed, 28 Jan 1998 19:45:48 +0000 (+0000)
Subject: 	* ld.texinfo (Options): Mention LDEMULATION in description of -m.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=f41751664d2e9e7a5145bed54d118f1c6ee82e43;p=binutils-gdb.git

	* ld.texinfo (Options): Mention LDEMULATION in description of -m.
	(Environment): Mention LDEMULATION.
---

diff --git a/ld/ChangeLog b/ld/ChangeLog
index 7f425265a7e..7055778f3eb 100644
--- a/ld/ChangeLog
+++ b/ld/ChangeLog
@@ -1,5 +1,8 @@
 Wed Jan 28 14:10:01 1998  Ian Lance Taylor  <ian@cygnus.com>
 
+	* 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  <rth@cygnus.com>
diff --git a/ld/ld.texinfo b/ld/ld.texinfo
index f03ccf87a99..03ce443362e 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