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.
This commit is contained in:
Nick Clifton 2020-01-08 17:00:54 +00:00
parent f1f28025c3
commit 915808f652
2 changed files with 20 additions and 9 deletions

View File

@ -1,3 +1,11 @@
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> 2020-01-08 Nick Clifton <nickc@redhat.com>
PR 14891 PR 14891

View File

@ -4404,11 +4404,11 @@ Some machine configurations provide additional directives.
* ABORT (COFF):: @code{.ABORT} * ABORT (COFF):: @code{.ABORT}
@end ifset @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} * Altmacro:: @code{.altmacro}
* Ascii:: @code{.ascii "@var{string}"}@dots{} * Ascii:: @code{.ascii "@var{string}"}@dots{}
* Asciz:: @code{.asciz "@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 * Bundle directives:: @code{.bundle_align_mode @var{abs-expr}}, etc
* Byte:: @code{.byte @var{expressions}} * Byte:: @code{.byte @var{expressions}}
* CFI directives:: @code{.cfi_startproc [simple]}, @code{.cfi_endproc}, etc. * 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}} * Octa:: @code{.octa @var{bignums}}
* Offset:: @code{.offset @var{loc}} * Offset:: @code{.offset @var{loc}}
* Org:: @code{.org @var{new-lc}, @var{fill}} * 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 @ifset ELF
* PopSection:: @code{.popsection} * PopSection:: @code{.popsection}
* Previous:: @code{.previous} * Previous:: @code{.previous}
@ -4607,13 +4607,14 @@ synonym for @samp{.abort}.
@end ifset @end ifset
@node Align @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 padding the location counter
@cindex @code{align} directive @cindex @code{align} directive
Pad the location counter (in the current subsection) to a particular storage Pad the location counter (in the current subsection) to a particular storage
boundary. The first expression (which must be absolute) is the alignment 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 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 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''. a zero byte. The ``z'' in @samp{.asciz} stands for ``zero''.
@node Balign @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 padding the location counter given number of bytes
@cindex @code{balign} directive @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 storage boundary. The first expression (which must be absolute) is the
alignment request in bytes. For example @samp{.balign 8} advances alignment request in bytes. For example @samp{.balign 8} advances
the location counter until it is a multiple of 8. If the location counter 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 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 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. @var{fill} defaults to zero.
@node P2align @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 padding the location counter given a power of two
@cindex @code{p2align} directive @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 number of low-order zero bits the location counter must have after
advancement. For example @samp{.p2align 3} advances the location advancement. For example @samp{.p2align 3} advances the location
counter until it is a multiple of 8. If the location counter is already a 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 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 padding bytes. It (and the comma) may be omitted. If it is omitted, the