This is the mail archive of the
binutils@sourceware.org
mailing list for the binutils project.
[PATCH v2] 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:13 +1100
- Subject: [PATCH v2] 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.
---
docs built using
$ make html
Changes since v1:
- Add menu item
- Add @
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