This is the mail archive of the
binutils@sourceware.org
mailing list for the binutils project.
[PATCH] Document .Nbyte assembler directives
- From: "Tobin C. Harding" <me at tobin dot cc>
- To: binutils at sourceware dot org
- Cc: "Tobin C . Harding" <me at tobin dot cc>
- Date: Mon, 6 Mar 2017 11:10:56 +1100
- Subject: [PATCH] Document .Nbyte assembler directives
- Authentication-results: sourceware.org; auth=none
GAS contains directives .2byte .4byte and .8byte. These directives are
used in the test suite but are undocumented.
Add documentation to GAS section 'Assembler Directives' for each of
directive.
---
I was not able to build work out how to build the docs locally. This
is my first patch to binutils. Please advise if format of patch or
patch content is not how the project likes it. Am happy to re-work to
fit in with your standards.
thanks
gas/doc/as.texinfo | 30 ++++++++++++++++++++++++++++++
1 file changed, 30 insertions(+)
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index 8c7fdfd..21c2b3b 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -7333,6 +7333,36 @@ so in can take an optional second argument of the value to store in the bytes
instead of zero. Using @samp{.zero} in this way would be confusing however.
@end ifclear
+@node .2byte
+@section @code{.2byte @var{expressions}}
+
+@cindex @code{2byte} directive
+@cindex two-byte integer
+@cindex integer, 2-byte
+@code{.2byte} expects zero or more expressions, separated by commas.
+Each expression is assembled into the next two bytes.
+
+@node .4byte
+@section @code{.4byte @var{expressions}}
+
+@cindex @code{4byte} directive
+@cindex four-byte integer
+@cindex integer, 4-byte
+@code{.4byte} expects zero or more expressions, separated by commas.
+Each expression is assembled into the next four bytes.
+
+@node .8byte
+@section @code{.8byte @var{bignums}}
+
+@cindex @code{8byte} directive
+@code{.8byte} expects zero or more bignums, separated by commas. For
+each bignum, it emits
+@ifclear bignum-16
+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.
+@cindex eight-byte integer
+@cindex integer, 8-byte
+
@node Deprecated
@section Deprecated Directives
--
2.7.4