Imagelibrary/binutils-gdb
1
0
Fork 1
mirror of https://github.com/bminor/binutils-gdb.git synced 2025-12-05 23:23:09 +00: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
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> 2023-02-28 Richard Ball <richard.ball@arm.com>
* testsuite/gas/aarch64/mec-invalid.d: New test. * 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. @code{.byte} expects zero or more expressions, separated by commas.
Each expression is assembled into the next byte. 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 @node CFI directives
@section CFI directives @section CFI directives
@subsection @code{.cfi_sections @var{section_list}} @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 The byte ordering is target dependent, as is the size and format of floating
point values. 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 @node Dcb
@section @code{.dcb[@var{size}] @var{number} [,@var{fill}]} @section @code{.dcb[@var{size}] @var{number} [,@var{fill}]}
@cindex @code{dcb} directive @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. The byte ordering is target dependent.
@ifset COFF @ifset COFF
@node Def @node Def
@section @code{.def @var{name}} @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 ifset
@end ifclear @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 @ifset ELF
@node Internal @node Internal
@section @code{.internal @var{names}} @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 @cindex integer, 16-byte
@end ifset @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 @node Reloc
@section @code{.reloc @var{offset}, @var{reloc_name}[, @var{expression}]} @section @code{.reloc @var{offset}, @var{reloc_name}[, @var{expression}]}
@@ -7017,6 +7036,11 @@ a 16 bit number for each.
@end ifset @end ifset
@end ifclear @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 @node Single
@section @code{.single @var{flonums}} @section @code{.single @var{flonums}}