major touch-up into presentable form

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

diff --git a/adoc/p_comma.adoc b/adoc/p_comma.adoc
index cca9e0b218b9dc076577967266890fcda19b513f..ae000355431e11c80fcf157eb4944029f20d4ac1 100644 (file)
--- a/adoc/p_comma.adoc
+++ b/adoc/p_comma.adoc
@@ -1,19 +1,24 @@
-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 )
-;
+.Word: ,
+[caption='Definition concept{counter:exec}: ']
+----
+: , 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,;>>.