diff options
Diffstat (limited to 'gas')
| -rw-r--r-- | gas/ChangeLog | 8 | ||||
| -rw-r--r-- | gas/doc/as.texi | 21 |
2 files changed, 20 insertions, 9 deletions
diff --git a/gas/ChangeLog b/gas/ChangeLog index 799c591..bed8292 100644 --- a/gas/ChangeLog +++ b/gas/ChangeLog @@ -1,5 +1,13 @@ 2020-01-08 Nick Clifton <nickc@redhat.com> + PR 25284 + * doc/as.texi (Align): Document the fact that all arguments can be + omitted. + (Balign): Likewise. + (P2align): Likewise. + +2020-01-08 Nick Clifton <nickc@redhat.com> + PR 14891 * config/obj-elf.c (obj_elf_section): Fail if the section name is already defined as a different symbol type. diff --git a/gas/doc/as.texi b/gas/doc/as.texi index 15b33fd..ab661a7 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 |