adding execution control words

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

diff --git a/adoc/p_colon.adoc b/adoc/p_colon.adoc
index 2fb446b8ccb939bf2e9820466b519a55bb872167..3a5acecd2ec6695b980c14b449dd32279b5f4044 100644 (file)
--- a/adoc/p_colon.adoc
+++ b/adoc/p_colon.adoc
@@ -1,8 +1,26 @@
-anchor:p_evaluate_stream[]
+// compile.asm:        WORD p_colon[],':'
 
-Word: :
--------
+anchor: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.
+
+====
+.Word: :
+[caption='Definition concept {counter:exec}: ']
 ----
-compile.asm:   WORD p_colon[],':'
+: : 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,;>>.