upgrade
authorRalph Ronnquist <ralph.ronnquist@gmail.com>
Sat, 12 Jun 2021 12:48:45 +0000 (22:48 +1000)
committerRalph Ronnquist <ralph.ronnquist@gmail.com>
Sat, 12 Jun 2021 12:48:45 +0000 (22:48 +1000)
reference.html
rrqforth

index 04da3738999684d452c0701a1335e93ede9ccd18..9cb4b59609eabf30834431443a2a66a96331f340 100644 (file)
@@ -770,12 +770,18 @@ asciidoc.install();
 <a href="#p_put">!</a> &#160;\r
 <a href="#p_Cget">C@</a> &#160;\r
 <a href="#p_Cput">C!</a> &#160;\r
+<a href="#p_Wget">W@</a> &#160;\r
+<a href="#p_Wput">W!</a> &#160;\r
+<a href="#p_Dget">D@</a> &#160;\r
+<a href="#p_Dput">D!</a> &#160;\r
 <a href="#p_2get">2@</a> &#160;\r
 <a href="#p_2put">2!</a> &#160;\r
 <a href="#p_put_plus">!&#43;</a> &#160;\r
 <a href="#p_get_n_increment">@n&#43;&#43;</a> &#160;\r
 <a href="#p_get_n_decrement">@n--</a> &#160;\r
 <a href="#p_Ccomma">C,</a> &#160;\r
+<a href="#p_Wcomma">W,</a> &#160;\r
+<a href="#p_Dcomma">D,</a> &#160;\r
 <a href="#p_literal_string_compile">S"</a> &#160;\r
 <a href="#p_gtR">&gt;R</a> &#160;\r
 <a href="#p_Rget">R@</a> &#160;\r
@@ -1142,6 +1148,52 @@ at the current free head address, which also is incremented.</p></div>
 <div style="text-align:center">\r
 _______________________________________________________\r
 </div>\r
+<div class="paragraph"><p><a id="p_Wcomma"></a></p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_word_w">Word: W,</h3>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>Data stack: ( v -- )</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>"W," (W-comma) is a function word that puts a "word" (double-byte) on\r
+the <a href="#p_here">HERE</a> heap. The two least significant bytes of the value\r
+are put at the current free head address, which also is incremented\r
+accordingly.</p></div>\r
+<div class="exampleblock">\r
+<div class="content">\r
+<div class="sidebarblock">\r
+<div class="content">\r
+<div class="title">Definition concept for W,</div>\r
+<div class="paragraph"><p>: W, HERE @ 2 ALLOT W! ;</p></div>\r
+</div></div>\r
+</div></div>\r
+<div style="text-align:center">\r
+_______________________________________________________\r
+</div>\r
+<div class="paragraph"><p><a id="p_Dcomma"></a></p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_word_d">Word: D,</h3>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>Data stack: ( v -- )</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>"D," (D-comma) is a function word that puts a "double word"\r
+(double-byte) on the <a href="#p_here">HERE</a> heap. The four least significant\r
+bytes of the value are put at the current free head address, which\r
+also is incremented accordingly.</p></div>\r
+<div class="exampleblock">\r
+<div class="content">\r
+<div class="sidebarblock">\r
+<div class="content">\r
+<div class="title">Definition concept for D,</div>\r
+<div class="paragraph"><p>: D, HERE @ 4 ALLOT D! ;</p></div>\r
+</div></div>\r
+</div></div>\r
+<div style="text-align:center">\r
+_______________________________________________________\r
+</div>\r
 <div class="paragraph"><p><a id="p_cfa2tfa"></a></p></div>\r
 </div>\r
 <div class="sect2">\r
@@ -1174,6 +1226,32 @@ _______________________________________________________
 <div style="text-align:center">\r
 _______________________________________________________\r
 </div>\r
+<div class="paragraph"><p><a id="p_Wget"></a></p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_word_w_2">Word: W@</h3>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>Data stack: ( a -- v )</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>"W@" is a function word that pushes the "word" (double-byte) value v\r
+from the address a.</p></div>\r
+<div style="text-align:center">\r
+_______________________________________________________\r
+</div>\r
+<div class="paragraph"><p><a id="p_Rget"></a></p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_word_r">Word: R@</h3>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>Data stack: ( -- v )   Return stack: ( v -- v )</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>"R@" is a function word that "copies" the top return stack value onto\r
+the data stack.</p></div>\r
+<div style="text-align:center">\r
+_______________________________________________________\r
+</div>\r
 <div class="paragraph"><p><a id="p_Cput"></a></p></div>\r
 </div>\r
 <div class="sect2">\r
@@ -1187,10 +1265,36 @@ significant byte of the cell) at the address a.</p></div>
 <div style="text-align:center">\r
 _______________________________________________________\r
 </div>\r
+<div class="paragraph"><p><a id="p_Wput"></a></p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_word_w_3">Word: W!</h3>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>Data stack: ( v a -- )</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>"W!" is a function word that stores the "word" (2-byte) value v (the\r
+two least significant bytes of the cell) at the address a.</p></div>\r
+<div style="text-align:center">\r
+_______________________________________________________\r
+</div>\r
+<div class="paragraph"><p><a id="p_Dput"></a></p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_word_d_2">Word: D!</h3>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>Data stack: ( v a -- )</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>"D!" is a function word that stores the "doublw word" (4-byte) value v\r
+(the four least significant bytes of the cell) at the address a.</p></div>\r
+<div style="text-align:center">\r
+_______________________________________________________\r
+</div>\r
 <div class="paragraph"><p><a id="p_Rget"></a></p></div>\r
 </div>\r
 <div class="sect2">\r
-<h3 id="_word_r">Word: R@</h3>\r
+<h3 id="_word_r_2">Word: R@</h3>\r
 <div class="literalblock">\r
 <div class="content">\r
 <pre><code>Data stack: ( -- v )   Return stack: ( v -- v )</code></pre>\r
@@ -3726,7 +3830,7 @@ is deepest.</p></div>
 <div id="footer">\r
 <div id="footer-text">\r
 Last updated\r
- 2021-06-11 19:04:48 AEST\r
+ 2021-06-12 22:46:13 AEST\r
 </div>\r
 </div>\r
 </body>\r
index 729f1bb4f4f0e974915eceba48699c6dda0a0dca..0e9771351e5d21651cad70daed8b33087d601c77 100755 (executable)
Binary files a/rrqforth and b/rrqforth differ