more and better documentation and some reorganisation

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

diff --git a/adoc/p_allot.adoc b/adoc/p_allot.adoc
index 78440106c47e3047635324c63d9256882035d51b..304ce2ab65fa0439111e69fc4e2ef5220e0762b9 100644 (file)
--- a/adoc/p_allot.adoc
+++ b/adoc/p_allot.adoc
@@ -12,20 +12,13 @@ Data stack: ( n -- )
 variable with +n+ so as to claim that amount of the heap.
 
 ====
-.Word: ALLOT
-[caption='Defintion concept {counter:exec}: ']
-----
-: ALLOT HERE @ + HERE ! ;
-----
-====
-
-====
-.Usage example
+.Defintion concept for ALLOT
 ****
-HERE @ 16 ALLOT ( -- p ; Claiming 16 bytes )
+( n -- ) : ALLOT HERE @ + HERE ! ;
 ****
 ====
 
-See also <<p_colon,:>>, <<p_here,HERE>>, <<p_get,@>>, <<p_plus,+>>,
-<<p_put,!>> and <<p_semicolon,;>>.
-
+====
+.Usage example {counter:example}: claim 16 bytes for variable FOO
+CREATE FOO DROP HERE @ 16 ALLOT
+====