Mercurial > hg > index.cgi
changeset 60:9ded7e6fc1b0
Updated documentation to include recently added features
author | lost@l-w.ca |
---|---|
date | Wed, 06 Apr 2011 20:31:37 -0600 |
parents | 1830faeef332 |
children | ccaecdff3fc2 |
files | docs/manual.docbook.sgml |
diffstat | 1 files changed, 24 insertions(+), 10 deletions(-) [+] |
line wrap: on
line diff
--- a/docs/manual.docbook.sgml Wed Apr 06 20:23:43 2011 -0600 +++ b/docs/manual.docbook.sgml Wed Apr 06 20:31:37 2011 -0600 @@ -1044,17 +1044,19 @@ assembler directive. Defining a macro can be considered equivalent to adding additional assembler directives. </para> -<para>Macros may accept parameters. These parameters are referenced within -a macro by the a backslash ("\") followed by a digit 1 through 9 for the first + +<para>Macros may accept parameters. These parameters are referenced within a +macro by the a backslash ("\") followed by a digit 1 through 9 for the first through ninth parameters. They may also be referenced by enclosing the -decimal parameter number in braces ("{num}"). These parameter references -are replaced with the verbatim text of the parameter passed to the macro. A -reference to a non-existent parameter will be replaced by an empty string. -Macro parameters are expanded everywhere on each source line. That means -the parameter to a macro could be used as a symbol or it could even appear -in a comment or could cause an entire source line to be commented out -when the macro is expanded. -</para> +decimal parameter number in braces ("{num}"). The special expansion "\*" +translates to the exact parameter string, including all parameters, passed +to the macro. These parameter references are replaced with the verbatim text +of the parameter passed to the macro. A reference to a non-existent +parameter will be replaced by an empty string. Macro parameters are expanded +everywhere on each source line. That means the parameter to a macro could be +used as a symbol or it could even appear in a comment or could cause an +entire source line to be commented out when the macro is expanded. </para> + <para> Parameters passed to a macro are separated by commas and the parameter list is terminated by any whitespace. This means that neither a comma nor whitespace @@ -1554,6 +1556,18 @@ </listitem> </varlistentry> +<varlistentry> +<term>shadow</term> +<listitem> + +<para>When this pragma is in effect, it becomes possible to define a macro +that matches an internal operation code. Thus, it makes it possible to +redefine either CPU instructions or pseudo operations. Because this feature +is of dubious utility, it is disabled by default.</para> + +</listitem> +</varlistentry> + </variablelist> </section>