upgrade

diff --git a/reference.html b/reference.html
index 9cb4b59609eabf30834431443a2a66a96331f340..7da9aa85489a9ae3834c2a452e98f543ff1622cd 100644 (file)
--- a/reference.html
+++ b/reference.html
@@ -786,7 +786,8 @@ asciidoc.install();
 <a href="#p_gtR">&gt;R</a> &#160;\r
 <a href="#p_Rget">R@</a> &#160;\r
 <a href="#p_Rgt">R&gt;</a> &#160;\r
-<a href="#p_rbpn">R[n]</a> &#160;</p></div>\r
+<a href="#p_rbpn">R[n]</a> &#160;\r
+<a href="#p_dsp">D[n]</a> &#160;</p></div>\r
 <div class="paragraph"><p><a href="#data_stack">DATA-STACK</a> &#160;\r
 <a href="#return_stack">RETURN-STACK</a> &#160;\r
 &#160;\r
@@ -864,6 +865,7 @@ asciidoc.install();
 <a href="#p_program_version">PROGRAM_VERSION</a> &#160;</p></div>\r
 <div class="paragraph"><p><a href="#p_quit">QUIT</a> &#160;</p></div>\r
 <div class="paragraph"><p><a href="#p_read_stream_char">READ-STREAM-CHAR</a> &#160;\r
+<a href="#p_read_stream_char">READ-STREAM-LINE</a> &#160;\r
 <a href="#p_read_word">READ-WORD</a> &#160;\r
 <a href="#p_realloc">REALLOC</a> &#160;\r
 <a href="#p_return">RETURN</a> &#160;\r
@@ -1194,6 +1196,19 @@ also is incremented accordingly.</p></div>
 <div style="text-align:center">\r
 _______________________________________________________\r
 </div>\r
+<div class="paragraph"><p><a id="p_dsp"></a></p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_word_d_n">Word: D[n]</h3>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>Data stack: ( n -- a )</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>"D[n]" is a function word that pushes the address for the n:th cell of\r
+the data stack onto the data stack.</p></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
@@ -1396,7 +1411,8 @@ _______________________________________________________
 </div></div>\r
 <div class="paragraph"><p>"ARGS" is a value word that holds a pointer to the command line data\r
 block which consists of a count cell followed by that many asciiz\r
-pointers and then a 0 cell.</p></div>\r
+pointers and then a 0 cell. That is next followed by the environment\r
+as a number of asciiz pointers and a 0 cell.</p></div>\r
 <div class="exampleblock">\r
 <div class="content">\r
 <div class="listingblock">\r
@@ -1404,9 +1420,10 @@ pointers and then a 0 cell.</p></div>
 <div class="content">\r
 <pre><code>ARGS -&gt; 8 bytes: count of non-zero asciiz pointers following\r
         8 bytes: command name string\r
-        8 bytes: first argument string\r
-        8* ...\r
-        8 zero</code></pre>\r
+        8* bytes: argument strings\r
+        8 bytes: zero cell\r
+        8* bytes: envirnment strings\r
+        8 bytes: zero cell</code></pre>\r
 </div></div>\r
 </div></div>\r
 <div style="text-align:center">\r
@@ -3038,8 +3055,8 @@ _______________________________________________________
 <div class="content">\r
 <pre><code>Data stack: ( n -- a )</code></pre>\r
 </div></div>\r
-<div class="paragraph"><p>"R[n]" is a function word that pushes the address for the n:th cell on\r
-the top return stack value onto the data stack.</p></div>\r
+<div class="paragraph"><p>"R[n]" is a function word that pushes the address for the n:th cell of\r
+the return stack onto the data stack.</p></div>\r
 <div class="exampleblock">\r
 <div class="content">\r
 <div class="sidebarblock">\r
@@ -3069,6 +3086,22 @@ instead.</p></div>
 <div style="text-align:center">\r
 _______________________________________________________\r
 </div>\r
+<div class="paragraph"><p><a id="p_read_stream_line"></a></p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_word_read_stream_line">Word: READ-STREAM-LINE</h3>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>Data stack: ( stream -- n )</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>"READ-STREAM-LINE" is a function word that gets the next line from the\r
+given stream buffer into PAD and returns number of characters. If the\r
+stream is backed by a file descriptor, the stream buffer is refilled\r
+from there as needed, by a SYS_READ call when more characters are\r
+needed.</p></div>\r
+<div style="text-align:center">\r
+_______________________________________________________\r
+</div>\r
 <div class="paragraph"><p><a id="p_read_word"></a></p></div>\r
 </div>\r
 <div class="sect2">\r
@@ -3830,7 +3863,7 @@ is deepest.</p></div>
 <div id="footer">\r
 <div id="footer-text">\r
 Last updated\r
- 2021-06-12 22:46:13 AEST\r
+ 2021-06-13 13:02:55 AEST\r
 </div>\r
 </div>\r
 </body>\r

diff --git a/rrqforth b/rrqforth
index 4a18d691cd0259c01dd2e639f3f1d5a35bdeab2d..9155a159520c3149b630e7317c44766b96b664a8 100755 (executable)
Binary files a/rrqforth and b/rrqforth differ