-anchor:p_allot[]
+// compile.asm: WORD p_allot,'ALLOT',fasm
-Word: ALLOT
------------
+anchor:p_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 !
-;
+.Defintion concept for ALLOT
+****
+( n -- ) : ALLOT HERE @ + HERE ! ;
+****
====
-.Usage example
====
-HERE @ 16 ALLOT ( -- p ; Claiming 16 bytes )
+.Usage example {counter:example}: claim 16 bytes for variable FOO
+CREATE FOO DROP HERE @ 16 ALLOT
====
-