[binutils-gdb] Update description of macro keyword argument assignment in assembler documentation.

[binutils-gdb] Update description of macro keyword argument assignment in assembler documentation.

[Nick Clifton]

https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=99daf56f4b4bf831bb29bffb79f2172f1b316cb9

commit 99daf56f4b4bf831bb29bffb79f2172f1b316cb9
Author: Nick Clifton <nickc@redhat.com>
Date:   Fri Apr 12 16:51:51 2024 +0100

    Update description of macro keyword argument assignment in assembler documentation.
    
      PR 31255

Diff:
---
 gas/doc/as.texi | 35 ++++++++++++++++++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/gas/doc/as.texi b/gas/doc/as.texi
index 1e122ccbbde..56b5b752b2f 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