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: Alan Modra <amodra at gmail dot com>
- Cc: binutils at sourceware dot org, "Tobin C . Harding" <me at tobin dot cc>
- Date: Mon, 6 Mar 2017 16:54:14 +1100
- Subject: [PATCH] Document .Nbyte assembler directives
- Authentication-results: sourceware.org; auth=none
- References: <1488779654-26121-1-git-send-email-me@tobin.cc>
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