From 8b1e5da10ab58d2aa5eb84bf27de511294f061ef Mon Sep 17 00:00:00 2001 From: Nick Clifton Date: Fri, 10 Mar 2017 15:42:04 +0000 Subject: [PATCH] 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. --- gas/ChangeLog | 7 +++++++ gas/doc/as.texinfo | 25 +++++++++++++++---------- 2 files changed, 22 insertions(+), 10 deletions(-) diff --git a/gas/ChangeLog b/gas/ChangeLog index 4a6a9f5f3e2..3673fd68778 100644 --- a/gas/ChangeLog +++ b/gas/ChangeLog @@ -1,3 +1,10 @@ +2017-03-10 Tobin C. Harding + Nick Clifton + + * 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 * config/tc-i386.c (_i386_insn): Add dir_encoding and diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo index a8f014ba78b..3b3e931c431 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 -- 2.30.2