using IFAGAIN instead

[rrq/rrqforth.git] / adoc / p_colon.adoc

diff --git a/adoc/p_colon.adoc b/adoc/p_colon.adoc
index 2fb446b8ccb939bf2e9820466b519a55bb872167..86b910449ff0e7ed8dfec00554bd99217b6a624c 100644 (file)
--- a/adoc/p_colon.adoc
+++ b/adoc/p_colon.adoc
@@ -1,8 +1,25 @@
-anchor:p_evaluate_stream[]
+// compile.asm:        WORD p_colon[],':'
 
-Word: :
--------
+anchor:p_colon[]
 
-----
-compile.asm:   WORD p_colon[],':'
-----
+=== Word: :
+
+
+....
+Data stack: ( -- )    Input stream: word
+....
+
+":" (colon) is a function word that starts a new forth definition.
+This includes reading the next word for making a new dictionary entry
+and setting evaluation state to compiling mode.
+
+====
+.Definition concept for :
+****
+: : doFORTH READ-WORD CREATE TFA>CFA ! ] ;
+****
+====
+
+See also <<p_doforth,doFORTH>>, <<p_read_word,READ-WORD>>,
+<<p_create,CREATE>>, <<p_tfa2cfa,TFA>CFA>>, <<p_put,!>>,
+<<p_left_bracket,]>> and <<p_semicolon,;>>.