From 2dd1c6e88aaef613ec07e6dac86e7c9e6e06d1cb Mon Sep 17 00:00:00 2001 From: Nick Clifton Date: Tue, 14 Mar 2023 11:19:45 +0000 Subject: [PATCH] Fix assembler documentation regarding data directives. PR 30206 * doc/as.texi (Pseudo Ops): Document that data directives such as .byte and .int are not intended for encoding instructions. --- gas/ChangeLog | 6 ++++++ gas/doc/as.texi | 26 +++++++++++++++++++++++++- 2 files changed, 31 insertions(+), 1 deletion(-) diff --git a/gas/ChangeLog b/gas/ChangeLog index 1e00ce3bb8d..213d1124f3d 100644 --- a/gas/ChangeLog +++ b/gas/ChangeLog @@ -1,3 +1,9 @@ +2023-03-14 Nick Clifton + + 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 * testsuite/gas/aarch64/mec-invalid.d: New test. diff --git a/gas/doc/as.texi b/gas/doc/as.texi index bbdfa4bfdca..353ff860f1b 100644 --- a/gas/doc/as.texi +++ b/gas/doc/as.texi @@ -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}} -- 2.30.2