mirror/binutils-gdb
2
0
Fork 0
mirror of https://sourceware.org/git/binutils-gdb.git synced 2025-04-24 14:53:34 +08:00
Code Issues Packages Projects Releases Wiki Activity

Fix assembler documentation regarding data directives.

Browse Source 
PR 30206
 * doc/as.texi (Pseudo Ops): Document that data directives such as .byte and .int are not intended for encoding instructions.
This commit is contained in:
Nick Clifton 2023-03-14 11:19:45 +00:00
parent c8b3d02c49
commit 2dd1c6e88a
2 changed files with 31 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
gas/ChangeLog
View File

@ -1,3 +1,9 @@
2023-03-14 Nick Clifton <nickc@redhat.com>
PR 30206
* doc/as.texi (Pseudo Ops): Document that data directives such as
.byte and .int are not intended for encoding instructions.
2023-02-28 Richard Ball <richard.ball@arm.com>
* testsuite/gas/aarch64/mec-invalid.d: New test.

26
gas/doc/as.texi
View File

@ -4878,6 +4878,11 @@ same number of @code{.bundle_lock} and @code{.bundle_unlock} directives.
@code{.byte} expects zero or more expressions, separated by commas.
Each expression is assembled into the next byte.
Note - this directive is not intended for encoding instructions, and it will
not trigger effects like DWARF line number generation. Instead some targets
support special directives for encoding arbitrary binary sequences as
instructions such as @code{.insn} or @code{.inst}.
@node CFI directives
@section CFI directives
@subsection @code{.cfi_sections @var{section_list}}
@ -5176,6 +5181,11 @@ If no suffix is used then @samp{.w} is assumed.
The byte ordering is target dependent, as is the size and format of floating
point values.
Note - these directives are not intended for encoding instructions, and they
will not trigger effects like DWARF line number generation. Instead some
targets support special directives for encoding arbitrary binary sequences as
instructions such as @code{.insn} or @code{.inst}.
@node Dcb
@section @code{.dcb[@var{size}] @var{number} [,@var{fill}]}
@cindex @code{dcb} directive
@ -5236,7 +5246,6 @@ If the @var{size} suffix is omitted then @samp{.w} is assumed.
The byte ordering is target dependent.
@ifset COFF
@node Def
@section @code{.def @var{name}}
@ -5771,6 +5780,11 @@ integers. On the H8/300H and the Renesas SH, however, @code{.int} emits
@end ifset
@end ifclear
Note - this directive is not intended for encoding instructions, and it will
not trigger effects like DWARF line number generation. Instead some targets
support special directives for encoding arbitrary binary sequences as
instructions such as eg @code{.insn} or @code{.inst}.
@ifset ELF
@node Internal
@section @code{.internal @var{names}}
@ -6586,6 +6600,11 @@ warning message; and just takes the lowest order 16 bytes of the bignum.
@cindex integer, 16-byte
@end ifset
Note - this directive is not intended for encoding instructions, and it will
not trigger effects like DWARF line number generation. Instead some targets
support special directives for encoding arbitrary binary sequences as
instructions such as @code{.insn} or @code{.inst}.
@node Reloc
@section @code{.reloc @var{offset}, @var{reloc_name}[, @var{expression}]}
@ -7017,6 +7036,11 @@ a 16 bit number for each.
@end ifset
@end ifclear
Note - this directive is not intended for encoding instructions, and it will
not trigger effects like DWARF line number generation. Instead some targets
support special directives for encoding arbitrary binary sequences as
instructions such as @code{.insn} or @code{.inst}.
@node Single
@section @code{.single @var{flonums}}