standardized call-out blocks

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

diff --git a/adoc/p_here.adoc b/adoc/p_here.adoc
index 116c817c34ba5281303a20b91e30d39f77cc4fb9..66aa8edcafceb6e0014e43e652c35203a14e72c3 100644 (file)
--- a/adoc/p_here.adoc
+++ b/adoc/p_here.adoc
@@ -1,12 +1,23 @@
+// compile.asm:        WORD p_here,'HERE',dovariable
+
 anchor:p_here[]
 
-Word: HERE
-----------
-----
-compile.asm:   WORD p_here,'HERE',dovariable
-----
+=== Word: HERE
+
+....
+Data stack: ( -- a )
+....
 
 "HERE" is a variable word that keeps the lowest address of the free
-allocation space. It get updated by all words that allocate space.
+allocation space. It get updated by all words that allocate memory.
+
 
+====
+.allocate 1024 bytes on the heap
+[caption='Usage example {counter:example} ']
+****
+1024 HEAP @ + HEAP !
+****
+====
 
+See also <<p_allot,ALLOT>>.