[binutils-gdb] Document that the .2byte and .4byte directives warn about overlarge values.

[Nick Clifton]

https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=8b1e5da10ab58d2aa5eb84bf27de511294f061ef

commit 8b1e5da10ab58d2aa5eb84bf27de511294f061ef
Author: Nick Clifton <nickc@redhat.com>
Date:   Fri Mar 10 15:42:04 2017 +0000

    Document that the .2byte and .4byte directives warn about overlarge values.
    
    	* doc/as.texinfo (2byte): Tidy up wording.  Add note that
    	overlarge values will produce a warning message and be trunacted.
    	(4byte): Likewise.

Diff:
---
 gas/ChangeLog      |  7 +++++++
 gas/doc/as.texinfo | 25 +++++++++++++++----------
 2 files changed, 22 insertions(+), 10 deletions(-)

diff --git a/gas/ChangeLog b/gas/ChangeLog
index 4a6a9f5..3673fd6 100644
--- a/gas/ChangeLog
+++ b/gas/ChangeLog
@@ -1,3 +1,10 @@
+2017-03-10  Tobin C. Harding  <me@tobin.cc>
+	    Nick Clifton  <nickc@redhat.com>
+
+	* doc/as.texinfo (2byte): Tidy up wording.  Add note that
+	overlarge values will produce a warning message and be trunacted.
+	(4byte): Likewise.
+
 2017-03-09  H.J. Lu  <hongjiu.lu@intel.com>
 
 	* config/tc-i386.c (_i386_insn): Add dir_encoding and
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index a8f014b..3b3e931 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -7345,9 +7345,11 @@ instead of zero.  Using @samp{.zero} in this way would be confusing however.
 @cindex two-byte integer
 @cindex integer, 2-byte
 
-This directive @code{.2byte}, which is available for ELF targets, expects zero
-or more expressions, separated by commas. Each expression is assembled into the
-next two bytes.
+This directive expects zero or more expressions, separated by commas.  Each
+expression is evaluated and placed in the next two bytes of the current
+section.  If an expression will not fit in two bytes, a warning message
+is displayed and the lowest two bytes of the expression's value are used.
+This directive is only available for ELF targets,
 
 @node 4byte
 @section @code{.4byte @var{expression} [, @var{expression}]*}
@@ -7355,9 +7357,11 @@ next two bytes.
 @cindex four-byte integer
 @cindex integer, 4-byte
 
-This directive @code{.4byte}, which is available for ELF targets, expects zero
-or more expressions, separated by commas. Each expression is assembled into the
-next four bytes.
+This directive expects zero or more expressions, separated by commas.  Each
+expression is evaluated and placed in the next four bytes of the current
+section.  If an expression will not fit in four bytes, a warning message
+is displayed and the lowest four bytes of the expression's value are used.
+This directive is only available for ELF targets,
 
 @node 8byte
 @section @code{.8byte @var{expression} [, @var{expression}]*}
@@ -7365,10 +7369,11 @@ next four bytes.
 @cindex eight-byte integer
 @cindex integer, 8-byte
 
-This directive @code{.8byte}, which is available for ELF targets, expects zero
-or more bignums, separated by commas.  For each bignum, it emits
-an 8-byte integer.  If the bignum won't fit in 8 bytes, it prints a
-warning message; and just takes the lowest order 8 bytes of the bignum.
+This directive expects zero or more expressions, separated by commas.  Each
+expression is evaluated and the resulting bignum is placed in the next eight
+bytes of the current section.  If an expression will not fit in eight bytes, a
+warning message is displayed and the lowest eight bytes of the expression's
+value are used.  This directive is only available for ELF targets,
 @end ifset
 
 @node Deprecated