From 915808f652b63746052b1ef59403650b45a30e4f Mon Sep 17 00:00:00 2001 From: Nick Clifton Date: Wed, 8 Jan 2020 17:00:54 +0000 Subject: [PATCH] Document the fact that the assembler's alignment pseudo-ops can be issued without any argumemtns. PR 25284 * doc/as.texi (Align): Document the fact that all arguments can be omitted. (Balign): Likewise. (P2align): Likewise. --- gas/ChangeLog | 8 ++++++++ gas/doc/as.texi | 21 ++++++++++++--------- 2 files changed, 20 insertions(+), 9 deletions(-) diff --git a/gas/ChangeLog b/gas/ChangeLog index 799c5918112..bed8292aff0 100644 --- a/gas/ChangeLog +++ b/gas/ChangeLog @@ -1,3 +1,11 @@ +2020-01-08 Nick Clifton + + PR 25284 + * doc/as.texi (Align): Document the fact that all arguments can be + omitted. + (Balign): Likewise. + (P2align): Likewise. + 2020-01-08 Nick Clifton PR 14891 diff --git a/gas/doc/as.texi b/gas/doc/as.texi index 15b33fdf63c..ab661a73dbe 100644 --- a/gas/doc/as.texi +++ b/gas/doc/as.texi @@ -4404,11 +4404,11 @@ Some machine configurations provide additional directives. * ABORT (COFF):: @code{.ABORT} @end ifset -* Align:: @code{.align @var{abs-expr} , @var{abs-expr}} +* Align:: @code{.align [@var{abs-expr}[, @var{abs-expr}[, @var{abs-expr}]]]} * Altmacro:: @code{.altmacro} * Ascii:: @code{.ascii "@var{string}"}@dots{} * Asciz:: @code{.asciz "@var{string}"}@dots{} -* Balign:: @code{.balign @var{abs-expr} , @var{abs-expr}} +* Balign:: @code{.balign [@var{abs-expr}[, @var{abs-expr}]]} * Bundle directives:: @code{.bundle_align_mode @var{abs-expr}}, etc * Byte:: @code{.byte @var{expressions}} * CFI directives:: @code{.cfi_startproc [simple]}, @code{.cfi_endproc}, etc. @@ -4496,7 +4496,7 @@ Some machine configurations provide additional directives. * Octa:: @code{.octa @var{bignums}} * Offset:: @code{.offset @var{loc}} * Org:: @code{.org @var{new-lc}, @var{fill}} -* P2align:: @code{.p2align @var{abs-expr}, @var{abs-expr}, @var{abs-expr}} +* P2align:: @code{.p2align [@var{abs-expr}[, @var{abs-expr}[, @var{abs-expr}]]]} @ifset ELF * PopSection:: @code{.popsection} * Previous:: @code{.previous} @@ -4607,13 +4607,14 @@ synonym for @samp{.abort}. @end ifset @node Align -@section @code{.align @var{abs-expr}, @var{abs-expr}, @var{abs-expr}} +@section @code{.align [@var{abs-expr}[, @var{abs-expr}[, @var{abs-expr}]]]} @cindex padding the location counter @cindex @code{align} directive Pad the location counter (in the current subsection) to a particular storage boundary. The first expression (which must be absolute) is the alignment -required, as described below. +required, as described below. If this expression is omitted then a default +value of 0 is used, effectively disabling alignment requirements. The second expression (also absolute) gives the fill value to be stored in the padding bytes. It (and the comma) may be omitted. If it is omitted, the @@ -4705,7 +4706,7 @@ trailing zero byte) into consecutive addresses. a zero byte. The ``z'' in @samp{.asciz} stands for ``zero''. @node Balign -@section @code{.balign[wl] @var{abs-expr}, @var{abs-expr}, @var{abs-expr}} +@section @code{.balign[wl] [@var{abs-expr}[, @var{abs-expr}[, @var{abs-expr}]]]} @cindex padding the location counter given number of bytes @cindex @code{balign} directive @@ -4713,7 +4714,8 @@ Pad the location counter (in the current subsection) to a particular storage boundary. The first expression (which must be absolute) is the alignment request in bytes. For example @samp{.balign 8} advances the location counter until it is a multiple of 8. If the location counter -is already a multiple of 8, no change is needed. +is already a multiple of 8, no change is needed. If the expression is omitted +then a default value of 0 is used, effectively disabling alignment requirements. The second expression (also absolute) gives the fill value to be stored in the padding bytes. It (and the comma) may be omitted. If it is omitted, the @@ -6258,7 +6260,7 @@ absolute expression. If the comma and @var{fill} are omitted, @var{fill} defaults to zero. @node P2align -@section @code{.p2align[wl] @var{abs-expr}, @var{abs-expr}, @var{abs-expr}} +@section @code{.p2align[wl] [@var{abs-expr}[, @var{abs-expr}[, @var{abs-expr}]]]} @cindex padding the location counter given a power of two @cindex @code{p2align} directive @@ -6267,7 +6269,8 @@ storage boundary. The first expression (which must be absolute) is the number of low-order zero bits the location counter must have after advancement. For example @samp{.p2align 3} advances the location counter until it is a multiple of 8. If the location counter is already a -multiple of 8, no change is needed. +multiple of 8, no change is needed. If the expression is omitted then a +default value of 0 is used, effectively disabling alignment requirements. The second expression (also absolute) gives the fill value to be stored in the padding bytes. It (and the comma) may be omitted. If it is omitted, the -- 2.30.2