From: Ralph Ronnquist <ralph.ronnquist@gmail.com>
Date: Fri, 4 Jun 2021 08:29:57 +0000 (+1000)
Subject: adding the AGAIN control word
X-Git-Url: https://git.rrq.au/?a=commitdiff_plain;h=ea06ac29b3258dd6b91801a5175066e81275667d;p=rrq%2Frrqforth.git

adding the AGAIN control word
---

diff --git a/reference.html b/reference.html
index 0fc06e1..609c422 100644
--- a/reference.html
+++ b/reference.html
@@ -793,6 +793,7 @@ asciidoc.install();
 <a href="#p_2over">2OVER</a> &#160;
 <a href="#p_2swap">2SWAP</a> &#160;</p></div>
 <div class="paragraph"><p><a href="#p_abs">ABS</a> &#160;
+<a href="#p_again">AGAIN</a> &#160;
 <a href="#p_allot">ALLOT</a> &#160;
 <a href="#p_and">AND</a> &#160;
 <a href="#inline_code">[ASM]</a> &#160;</p></div>
@@ -1191,6 +1192,23 @@ value. To that end, the values are 64-bit signed integers.</p></div>
 <div style="text-align:center">
 _______________________________________________________
 </div>
+<div class="paragraph"><p><a id="p_again"></a></p></div>
+</div>
+<div class="sect2">
+<h3 id="_word_again">Word: AGAIN</h3>
+<div class="literalblock">
+<div class="content">
+<pre><code>Data stack: Compiling: ( -- a )</code></pre>
+</div></div>
+<div class="paragraph"><p>"AGAIN" is an immediate function word that is used together with
+<a href="#p_begin">BEGIN</a> and instead of <a href="#p_end">END</a> to implement structured
+execution control. AGAIN scans the datastack for the nearest preceding
+BEGIN marker and lays out an unconditional branch from this point the
+beginning of the block during execution. It thereafter performs the
+<a href="#p_end">END</a> compile action to end the block.</p></div>
+<div style="text-align:center">
+_______________________________________________________
+</div>
 <div class="paragraph"><p><a id="p_allot"></a></p></div>
 </div>
 <div class="sect2">
@@ -3411,7 +3429,7 @@ is deepest.</p></div>
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2021-06-03 21:07:44 AEST
+ 2021-06-04 18:26:45 AEST
 </div>
 </div>
 </body>