Add documentation about the interation of the ARM assembler's -EB option and the...

	PR binutils/18198
	* ld.texinfo (--be8): Add a note about the interaction of this
	option with the assembler's -EB option.

	* doc/c-arm.texi (ARM Options): Add a note about the interaction of
	the -EB option with the linker's --be8 option.

diff --git a/gas/ChangeLog b/gas/ChangeLog
index fb4355eb787d1bff4cd3857df68d6dc0254625bb..636ef3c6fd5d4cafceda7eb8c2d9644a578d0677 100644 (file)
--- a/gas/ChangeLog
+++ b/gas/ChangeLog
@@ -1,3 +1,9 @@
+2015-04-10  Nick Clifton  <nickc@redhat.com>
+
+       PR binutils/18198
+       * doc/c-arm.texi (ARM Options): Add a note about the interaction of
+       the -EB option with the linker's --be8 option.
+
 2015-04-09  Hans-Peter Nilsson  <hp@axis.com>
 
        * doc/c-rx.texi: Fix markup typos in last change.

diff --git a/gas/doc/c-arm.texi b/gas/doc/c-arm.texi
index 18becb7aa37801b986660a813253fe56813a0703..f07aa62bd41064ccb1e121680d9a86962d6fc0b2 100644 (file)
--- a/gas/doc/c-arm.texi
+++ b/gas/doc/c-arm.texi
@@ -362,6 +362,12 @@ and
 This option specifies that the output generated by the assembler should
 be marked as being encoded for a big-endian processor.
 
+Note: If a program is being built for a system with big-endian data
+and little-endian instructions then it should be assembled with the
+@option{-EB} option, (all of it, code and data) and then linked with
+the @option{--be8} option.  This will reverse the endianness of the
+instructions back to little-endian, but leave the data as big-endian.
+
 @cindex @code{-EL} command line option, ARM
 @item -EL
 This option specifies that the output generated by the assembler should

diff --git a/ld/ChangeLog b/ld/ChangeLog
index b4d3ceb63c97b536fbb1219bebf01464c807930e..da54c5c5605679c7e130cc9af3b5349d15338807 100644 (file)
--- a/ld/ChangeLog
+++ b/ld/ChangeLog
@@ -1,3 +1,9 @@
+2015-04-10  Nick Clifton  <nickc@redhat.com>
+
+       PR binutils/18198
+       * ld.texinfo (--be8): Add a note about the interaction of this
+       option with the assembler's -EB option.
+
 2015-04-10  Alan Modra  <amodra@gmail.com>
 
        PR ld/18223

diff --git a/ld/ld.texinfo b/ld/ld.texinfo
index 82735e9558d8c7b6562827e0ebbeb7eb72b78a38..5384c98bd154f749cd3053b74f61fc64f9391d59 100644 (file)
--- a/ld/ld.texinfo
+++ b/ld/ld.texinfo
@@ -6424,8 +6424,10 @@ import tables. By default this option is turned off.
 @cindex BE8
 @kindex --be8
 The @samp{--be8} switch instructs @command{ld} to generate BE8 format
-executables.  This option is only valid when linking big-endian objects.
-The resulting image will contain big-endian data and little-endian code.
+executables.  This option is only valid when linking big-endian
+objects - ie ones which have been assembled with the @option{-EB}
+option.  The resulting image will contain big-endian data and
+little-endian code.
 
 @cindex TARGET1
 @kindex --target1-rel