X-Git-Url: https://git.rrq.au/?a=blobdiff_plain;f=adoc%2Fp_comma.adoc;h=f3064b720db5868d798c21c23cb17b31bbd40d76;hb=8a2d8dc0e8ff7f3e6b402d2d496169d19d032db5;hp=cca9e0b218b9dc076577967266890fcda19b513f;hpb=b7da3f7bbd1cb10241163abdb950472e539e796d;p=rrq%2Frrqforth.git

diff --git a/adoc/p_comma.adoc b/adoc/p_comma.adoc
index cca9e0b..f3064b7 100644
--- a/adoc/p_comma.adoc
+++ b/adoc/p_comma.adoc
@@ -1,19 +1,23 @@
-Word: ,
--------
+// compile.asm:	WORD p_comma,',',fasm
+
 anchor:p_comma[]
-----
-compile.asm:	WORD p_comma,',',fasm
-----
 
+=== Word: ,
+
+
+....
 Data stack: ( v -- )
+....
 
-"," is a function word that puts a cell on the heap.
+"," (comma) is a function word that puts a cell value on the
+<<p_here,HERE>> heap.
 
-.Execution semantics expressed in RRQFORTH
 ====
-: ,
-  HERE @ 8 ALLOT ! ( v -- ; Claim 8 bytes and put value there )
-;
+.Definition concept for ,
+****
+: , HERE @ 8 ALLOT ! ; ( v -- ; Claim 8 bytes and put value there )
+****
 ====
 
-
+See also <<p_colon,:>>, <<p_Ccomma>>. <<p_here,HERE>>, <<p_get,@>>,
+<<p_allot,ALLOT>>, <<p_put,!>> and <<p_semicolon,;>>.