diff options
author | Nick Clifton <nickc@redhat.com> | 2024-04-12 16:51:51 +0100 |
---|---|---|
committer | Nick Clifton <nickc@redhat.com> | 2024-04-12 16:51:51 +0100 |
commit | 99daf56f4b4bf831bb29bffb79f2172f1b316cb9 (patch) | |
tree | ec47e00bd15705b836652211f80e61e4333fd2f3 /gas | |
parent | 3d67591c6ff0443e36cbc38ece082cc240e87bf6 (diff) | |
download | binutils-99daf56f4b4bf831bb29bffb79f2172f1b316cb9.zip binutils-99daf56f4b4bf831bb29bffb79f2172f1b316cb9.tar.gz binutils-99daf56f4b4bf831bb29bffb79f2172f1b316cb9.tar.bz2 |
Update description of macro keyword argument assignment in assembler documentation.
PR 31255
Diffstat (limited to 'gas')
-rw-r--r-- | gas/doc/as.texi | 35 |
1 files changed, 34 insertions, 1 deletions
diff --git a/gas/doc/as.texi b/gas/doc/as.texi index 1e122cc..56b5b75 100644 --- a/gas/doc/as.texi +++ b/gas/doc/as.texi @@ -4781,6 +4781,10 @@ write @samp{<4.3 !> 5.4!!>} to get the literal text @samp{4.3 > 5.4!}. @item Expression results as strings You can write @samp{%@var{expr}} to evaluate the expression @var{expr} and use the result as a string. + +@item No passing arguments to macros based upon keyword assignment. +In altmacro mode arguments cannot be passed to macros by keyword assignment. +See @xref{altmacro-keyword-arguments} for more details @end ftable @node Ascii @@ -6217,7 +6221,36 @@ will get assigned all remaining arguments specified at invocation time. When you call a macro, you can specify the argument values either by position, or by keyword. For example, @samp{sum 9,17} is equivalent to -@samp{sum to=17, from=9}. +@samp{sum to=17, from=9}. You can also omit values when using keywords, +so for example @samp{sum to=6} is equivalent to @samp{sum 0, 6}. + +@anchor{altmacro-keyword-arguments} +Note however that when operating in altmacro mode arguments can only be +specified by position, not keyword. @xref{Altmacro,,@code{.altmacro}}. + +Thus for example: + +@example +.altmacro +.macro foo bar=1, baz=2 +.print "\bar \baz" +.endm + +foo baz=3 +@end example + +Will print: + +@smallexample +baz=3 2 +@end smallexample + +Rather than the expected: + +@smallexample +1 3 +@end smallexample + @end table |