document the INPUT word

diff --git a/adoc/p_input.adoc b/adoc/p_input.adoc
new file mode 100644 (file)
index 0000000..d5f8022
--- /dev/null
+++ b/adoc/p_input.adoc
@@ -0,0 +1,13 @@
+// compile.asm:        WORD p_input,'INPUT',dovariable
+
+anchor:p_input[]
+
+=== Word: INPUT
+
+....
+Data stack: ( -- a )
+....
+
+"INPUT" is a variable word for the input stream buffer used by
+<<p_evaluate_stream,EVALUATE-STREAM>>.
+

diff --git a/reference.adoc b/reference.adoc
index 9175d73450e94645fca06df0fe62b9e2db686ca9..1700ddf714b8720640baf6479c47ebe9558dc211 100644 (file)
--- a/reference.adoc
+++ b/reference.adoc
@@ -153,6 +153,8 @@ include::adoc/p_ifbreak.adoc[]
 include::separator.adoc[]
 include::adoc/p_immediate.adoc[]
 include::separator.adoc[]
+include::adoc/p_input.adoc[]
+include::separator.adoc[]
 include::adoc/p_left_bracket.adoc[]
 include::separator.adoc[]
 include::adoc/p_lessequal.adoc[]

diff --git a/reference.html b/reference.html
index f49869a4eb7329644a6d974173b691fbe9fb4fd5..0fc06e19112a3d6eea43df52850d7670d96558cd 100644 (file)
--- a/reference.html
+++ b/reference.html
@@ -832,7 +832,8 @@ asciidoc.install();
 <div class="paragraph"><p><a href="#p_if">IF</a> &#160;\r
 <a href="#p_ifagain">IFAGAIN</a> &#160;\r
 <a href="#p_ifbreak">IFBREAK</a> &#160;\r
-<a href="#p_immediate">IMMEDIATE</a> &#160;</p></div>\r
+<a href="#p_immediate">IMMEDIATE</a> &#160;\r
+<a href="#p_input">INPUT</a> &#160;</p></div>\r
 <div class="paragraph"><p><a href="#p_literal">LIT</a> &#160;\r
 <a href="#p_load_file_quote">LOAD-FILE"</a> &#160;</p></div>\r
 <div class="paragraph"><p><a href="#p_args">MAIN-ARGS</a> &#160;\r
@@ -2338,6 +2339,19 @@ the most recent word to 1, thereby making that word an immediate word.</p></div>
 <div style="text-align:center">\r
 _______________________________________________________\r
 </div>\r
+<div class="paragraph"><p><a id="p_input"></a></p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_word_input">Word: INPUT</h3>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>Data stack: ( -- a )</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>"INPUT" is a variable word for the input stream buffer used by\r
+<a href="#p_evaluate_stream">EVALUATE-STREAM</a>.</p></div>\r
+<div style="text-align:center">\r
+_______________________________________________________\r
+</div>\r
 <div class="paragraph"><p><a id="p_left_bracket"></a></p></div>\r
 </div>\r
 <div class="sect2">\r
@@ -3397,7 +3411,7 @@ is deepest.</p></div>
 <div id="footer">\r
 <div id="footer-text">\r
 Last updated\r
- 2021-06-02 01:27:44 AEST\r
+ 2021-06-03 21:07:44 AEST\r
 </div>\r
 </div>\r
 </body>\r

diff --git a/wordindex.adoc b/wordindex.adoc
index 8623a0bc23edd8b10d4c9ecbea3beed82f5fe2d1..ebac8532ee0c4ce0606f8637eaa7281edfbf004f 100644 (file)
--- a/wordindex.adoc
+++ b/wordindex.adoc
@@ -105,6 +105,7 @@ xref:p_if[IF] {nbsp}
 xref:p_ifagain[IFAGAIN] {nbsp}
 xref:p_ifbreak[IFBREAK] {nbsp}
 xref:p_immediate[IMMEDIATE] {nbsp}
+xref:p_input[INPUT] {nbsp}
 
 xref:p_literal[LIT] {nbsp}
 xref:p_load_file_quote[LOAD-FILE"] {nbsp}