X-Git-Url: https://git.rrq.au/?a=blobdiff_plain;f=reference.html;h=988e55177cc3476fd286dc94d7b0324a2893bef9;hb=0391d16ece3a9f4d7d023ae1f0be610b8a915fc3;hp=a1de89cbf7de1fde99526c0439f3bba94bdd8a81;hpb=d578692bf8e65d9448c48ea8dae7dd6642e03622;p=rrq%2Frrqforth.git

diff --git a/reference.html b/reference.html
index a1de89c..988e551 100644
--- a/reference.html
+++ b/reference.html
@@ -806,6 +806,7 @@ asciidoc.install();
 <a href="#p_create">CREATE</a> &#160;
 <a href="#p_current_wordlist">CURRENT-WORDLIST</a> &#160;</p></div>
 <div class="paragraph"><p><a href="#p_decimal">DECIMAL</a> &#160;
+<a href="#p_definitions">DEFINITIONS</a> &#160;
 <a href="#p_depth">DEPTH</a> &#160;
 <a href="#p_digits">DIGITS</a> &#160;
 <a href="#p_divmod">/MOD</a> &#160;
@@ -858,6 +859,7 @@ asciidoc.install();
 <div class="paragraph"><p><a href="#p_read_stream_char">READ-STREAM-CHAR</a> &#160;
 <a href="#p_read_word">READ-WORD</a> &#160;
 <a href="#p_realloc">REALLOC</a> &#160;
+<a href="#p_return">RETURN</a> &#160;
 <a href="#p_roll">ROLL</a> &#160;
 <a href="#p_rot">ROT</a> &#160;
 <a href="#p_rbp">RSP</a> &#160;</p></div>
@@ -882,7 +884,8 @@ asciidoc.install();
 <a href="#p_this_word">THIS-WORD</a> &#160;
 <a href="#p_true">TRUE</a> &#160;
 <a href="#p_tuck">TUCK</a> &#160;</p></div>
-<div class="paragraph"><p><a href="#p_unstream">UNSTREAM</a> &#160;</p></div>
+<div class="paragraph"><p><a href="#p_unstream">UNSTREAM</a> &#160;
+<a href="#p_use">USE</a> &#160;</p></div>
 <div class="paragraph"><p><a href="#p_verboseQ">VERBOSE?</a> &#160;</p></div>
 <div class="paragraph"><p><a href="#p_within">WITHIN</a> &#160;
 <a href="#p_words">WORDS</a> &#160;</p></div>
@@ -1655,6 +1658,27 @@ _______________________________________________________
 <div style="text-align:center">
 _______________________________________________________
 </div>
+<div class="paragraph"><p><a id="p_definitions"></a></p></div>
+</div>
+<div class="sect2">
+<h3 id="_word_definitions">Word: DEFINITIONS</h3>
+<div class="literalblock">
+<div class="content">
+<pre><code>Data stack: ( wordlist -- )</code></pre>
+</div></div>
+<div class="paragraph"><p>"DEFINITIONS" is a function word that installs the given wordlist as
+the <a href="#p_current_wordlist">CURRENT-WORDLIST</a> one.</p></div>
+<div class="exampleblock">
+<div class="content">
+<div class="sidebarblock">
+<div class="content">
+<div class="title">Definition concept for DEFINITIONS</div>
+<div class="paragraph"><p>: DEFINITIONS CURRENT-WORDLIST ! ;</p></div>
+</div></div>
+</div></div>
+<div style="text-align:center">
+_______________________________________________________
+</div>
 <div class="paragraph"><p><a id="p_depth"></a></p></div>
 </div>
 <div class="sect2">
@@ -2133,11 +2157,10 @@ _______________________________________________________
 <h3 id="_word_exit">Word: EXIT</h3>
 <div class="literalblock">
 <div class="content">
-<pre><code>Data stack: ( -- )</code></pre>
+<pre><code>Data stack: ( v -- )</code></pre>
 </div></div>
-<div class="paragraph"><p>"EXIT" is a function word that implements the ending of a FORTH
-definition and its threading to the subsequent step of the calling
-definition.</p></div>
+<div class="paragraph"><p>"EXIT" is a function word that terminates the <code>rrqforth</code> process
+immediately with the given exit code.</p></div>
 <div style="text-align:center">
 _______________________________________________________
 </div>
@@ -2966,6 +2989,20 @@ kernel, and the granularity is in pages, i.e. a multiple of 4 kb.</p></div>
 <div style="text-align:center">
 _______________________________________________________
 </div>
+<div class="paragraph"><p><a id="p_return"></a></p></div>
+</div>
+<div class="sect2">
+<h3 id="_word_return">Word: RETURN</h3>
+<div class="literalblock">
+<div class="content">
+<pre><code>Data stack: ( -- )</code></pre>
+</div></div>
+<div class="paragraph"><p>"RETURN" is a function word that implements the ending of a FORTH
+definition and make execution return to the next step in the calling
+definition.</p></div>
+<div style="text-align:center">
+_______________________________________________________
+</div>
 <div class="paragraph"><p>compile.asm:    WORD p_right_bracket,<em>]</em>,fasm</p></div>
 <div class="paragraph"><p><a id="p_right_bracket"></a></p></div>
 </div>
@@ -3483,10 +3520,26 @@ at (stream* + 16) is its size.</p></div>
 <div style="text-align:center">
 _______________________________________________________
 </div>
-<div class="paragraph"><p><a id="p_verboseQ"></a></p></div>
+<div class="paragraph"><p><a id="p_use"></a></p></div>
 </div>
 </div>
 <div class="sect2">
+<h3 id="_word_use">Word: USE</h3>
+<div class="literalblock">
+<div class="content">
+<pre><code>Data value: ( wordlist -- )  Input stream: word</code></pre>
+</div></div>
+<div class="paragraph"><p>"USE" is a function word that looks up next word given the wordlist.
+It reads next word on <a href="#p_input">INPUT</a> via <a href="#p_read_word">READ-WORD</a>,
+then temporarily changes <a href="#p_current_wordlist">CURRENT-WORDLIST</a> to
+<a href="#p_find">FIND</a> the word via the given wordlist, and returns the TFA
+of that word, or just 0 if the word coudn&#8217;t be found.</p></div>
+<div style="text-align:center">
+_______________________________________________________
+</div>
+<div class="paragraph"><p><a id="p_verboseQ"></a></p></div>
+</div>
+<div class="sect2">
 <h3 id="_word_verbose">Word: VERBOSE?</h3>
 <div class="literalblock">
 <div class="content">
@@ -3575,7 +3628,7 @@ is deepest.</p></div>
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2021-06-06 09:36:53 AEST
+ 2021-06-06 23:19:36 AEST
 </div>
 </div>
 </body>