aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorIan C <ianc@noddybox.co.uk>2016-03-08 13:51:57 +0000
committerIan C <ianc@noddybox.co.uk>2016-03-08 13:51:57 +0000
commit282fa7725993c9b0b0d2bb0977c124f11abea1fd (patch)
treee798be921f3cfc51ef0ca39c195a07218defc8d8 /doc
parent3bad2fc2e05e0ddbf7d398f120b6d5d525476ff9 (diff)
Wildcard for args, EX changes and CP/M test.
+ Added '*' wildcard for macro arguments + Allow 'EX' with parameters reversed on the Z80 + Added simple CP/M example test. + Added some files to gitignore
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.asciidoc26
-rw-r--r--doc/manual.html27
-rw-r--r--doc/manual.pdfbin145493 -> 148743 bytes
3 files changed, 50 insertions, 3 deletions
diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc
index 888a9f0..99d07f6 100644
--- a/doc/manual.asciidoc
+++ b/doc/manual.asciidoc
@@ -317,7 +317,9 @@ Macros
~~~~~~
Macros can be defined in one of two ways; either parameterless or with named
-parameters. Macro names are case-insensitive.
+parameters. Macro names are case-insensitive. In the parameterless mode the
+special identifier '*' can be used to expand all arguments, which will be
+separated with commas.
----
macro1: macro
@@ -325,6 +327,7 @@ macro1: macro
ld a,\1
ld b,\2
call \3
+ defb \*
endm
@@ -456,6 +459,27 @@ EOR can be used the same as XOR:
and b
----
+For exchange opcodes with parameters the parameters can be reversed from their
+official form:
+
+----
+ ; The official forms
+ ;
+ ex de,hl
+ ex af,af'
+ ex (sp),hl
+ ex (sp),ix
+ ex (sp),iy
+
+ ; Also supported
+ ;
+ ex hl,de
+ ex af',af
+ ex hl,(sp)
+ ex ix,(sp)
+ ex iy,(sp)
+----
+
Where the high/low register parts of the IX and IY registers are to be used,
simply use ixl, iyl, ixh and iyh. Note that the assembler will accept
illegal pairings involving H and L, but these will be warned about:
diff --git a/doc/manual.html b/doc/manual.html
index 4aa250c..c25be2e 100644
--- a/doc/manual.html
+++ b/doc/manual.html
@@ -1259,7 +1259,9 @@ cbm
<div class="sect2">
<h3 id="_macros">Macros</h3>
<div class="paragraph"><p>Macros can be defined in one of two ways; either parameterless or with named
-parameters. Macro names are case-insensitive.</p></div>
+parameters. Macro names are case-insensitive. In the parameterless mode the
+special identifier <em>*</em> can be used to expand all arguments, which will be
+separated with commas.</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>macro1: macro
@@ -1267,6 +1269,7 @@ parameters. Macro names are case-insensitive.</p></div>
ld a,\1
ld b,\2
call \3
+ defb \*
endm
@@ -1477,6 +1480,26 @@ EOR can be used the same as XOR:</p></div>
and a,b ; These are equivalent
and b</tt></pre>
</div></div>
+<div class="paragraph"><p>For exchange opcodes with parameters the parameters can be reversed from their
+official form:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><tt> ; The official forms
+ ;
+ ex de,hl
+ ex af,af'
+ ex (sp),hl
+ ex (sp),ix
+ ex (sp),iy
+
+ ; Also supported
+ ;
+ ex hl,de
+ ex af',af
+ ex hl,(sp)
+ ex ix,(sp)
+ ex iy,(sp)</tt></pre>
+</div></div>
<div class="paragraph"><p>Where the high/low register parts of the IX and IY registers are to be used,
simply use ixl, iyl, ixh and iyh. Note that the assembler will accept
illegal pairings involving H and L, but these will be warned about:</p></div>
@@ -1570,7 +1593,7 @@ lda $8000,x ; Produces $bd $00 $80</tt></pre>
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
-Last updated 2016-01-27 16:12:35 GMT
+Last updated 2016-03-08 13:51:08 GMT
</div>
</div>
</body>
diff --git a/doc/manual.pdf b/doc/manual.pdf
index d39db3e..5cd5ea7 100644
--- a/doc/manual.pdf
+++ b/doc/manual.pdf
Binary files differ