ld/doc: Document that multiple MEMORY commands are allowed.

The linker documentation explicitly states that there can be only one
MEMORY command.  This is not true.  Multiple MEMORY commands are
allowed, the contents of all will be treated as if a single MEMORY
command was given.

Update the documentation to make this clear to the users.

ld/ChangeLog:

	* ld.texinfo (MEMORY): Explain that multiple MEMORY commands are
	acceptable.

diff --git a/ld/ChangeLog b/ld/ChangeLog
index d1b819bc12816112e5c693bb17b01ca97ab128e8..e0403295b47f2a3a65c1e3fe8aebe0c6744d577e 100644 (file)
--- a/ld/ChangeLog
+++ b/ld/ChangeLog
@@ -1,3 +1,8 @@
+2015-08-03  Andrew Burgess  <andrew.burgess@embecosm.com>
+
+       * ld.texinfo (MEMORY): Explain that multiple MEMORY commands are
+       acceptable.
+
 2015-07-29  H.J. Lu  <hongjiu.lu@intel.com>
 
        * lexsup.c (parse_args): Don't set link_info.executable to

diff --git a/ld/ld.texinfo b/ld/ld.texinfo
index b48396d06bb6ae7f824c813e78136653abe90373..8a7a08f981ed8da848deca29731c9bd0b235df8d 100644 (file)
--- a/ld/ld.texinfo
+++ b/ld/ld.texinfo
@@ -4970,9 +4970,10 @@ set section addresses based on the memory regions, and will warn about
 regions that become too full.  The linker will not shuffle sections
 around to fit into the available regions.
 
-A linker script may contain at most one use of the @code{MEMORY}
-command.  However, you can define as many blocks of memory within it as
-you wish.  The syntax is:
+A linker script may contain many uses of the @code{MEMORY} command,
+however, all memory blocks defined are treated as if they were
+specified inside a single @code{MEMORY} command.  The syntax for
+@code{MEMORY} is:
 @smallexample
 @group
 MEMORY