This is the mail archive of the
binutils@sourceware.org
mailing list for the binutils project.
[PATCH v2 RESEND] 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:58:06 +1100
- Subject: [PATCH v2 RESEND] 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.
---
docs built using
$ make html
Changes since v1:
- Add menu item
- Add ifset ELF
- Verified .8byte truncation warning
gas/doc/as.texinfo | 44 ++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 44 insertions(+)
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index 8c7fdfd..9030b06 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -4555,6 +4555,11 @@ Some machine configurations provide additional directives.
@ifclear no-space-dir
* Zero:: @code{.zero @var{size}}
@end ifclear
+@ifset ELF
+* 2byte:: @code{.2byte @var{expressions}}
+* 4byte:: @code{.4byte @var{expressions}}
+* 8byte:: @code{.8byte @var{bignums}}
+@end ifset
* Deprecated:: Deprecated Directives
@end menu
@@ -7333,6 +7338,45 @@ 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
+@cindex @code{local} directive
+This directive, which is available for ELF targets, marks each symbol in
+the comma-separated list of @code{names} as a local symbol so that it
+will not be externally visible. If the symbols do not already exist,
+they will be created.
+
+@ifset ELF
+@node 2byte
+@section @code{.2byte @var{expressions}}
+
+@cindex @code{2byte} directive
+@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.
+
+@node 4byte
+@section @code{.4byte @var{expressions}}
+
+@cindex @code{4byte} directive
+@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.
+
+@node 8byte
+@section @code{.8byte @var{bignums}}
+
+@cindex @code{8byte} directive
+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.
+@cindex eight-byte integer
+@cindex integer, 8-byte
+@end ifset
+
@node Deprecated
@section Deprecated Directives
--
2.7.4