X-Git-Url: https://git.rrq.au/?a=blobdiff_plain;f=adoc%2Fp_allot.adoc;h=78440106c47e3047635324c63d9256882035d51b;hb=f0b6d5b7831eff95b587bff49e5069e94503fb5c;hp=cf6e3b9e1e27f553b3e021259ce77be2a31e127e;hpb=b7da3f7bbd1cb10241163abdb950472e539e796d;p=rrq%2Frrqforth.git

diff --git a/adoc/p_allot.adoc b/adoc/p_allot.adoc
index cf6e3b9..7844010 100644
--- a/adoc/p_allot.adoc
+++ b/adoc/p_allot.adoc
@@ -1,26 +1,31 @@
+// compile.asm:	WORD p_allot,'ALLOT',fasm
+
 anchor:p_allot[]
 
-Word: ALLOT
------------
-
-----
-compile.asm:	WORD p_allot,'ALLOT',fasm
-----
+=== Word: ALLOT
 
+....
 Data stack: ( n -- )
+....
 
-"ALLOT" is a function word that merely increments the "HERE" variable
-with +n+ so as to claim that amount of the allocation space.
+"ALLOT" is a function word that merely increments the <<p_here,HERE>>
+variable with +n+ so as to claim that amount of the heap.
 
-.Execution semantics expressed in RRQFORTH
 ====
-: ALLOT
-  HERE @ + HERE !
-;
+.Word: ALLOT
+[caption='Defintion concept {counter:exec}: ']
+----
+: ALLOT HERE @ + HERE ! ;
+----
 ====
 
-.Usage example
 ====
+.Usage example
+****
 HERE @ 16 ALLOT ( -- p ; Claiming 16 bytes )
+****
 ====
 
+See also <<p_colon,:>>, <<p_here,HERE>>, <<p_get,@>>, <<p_plus,+>>,
+<<p_put,!>> and <<p_semicolon,;>>.
+