major touch-up into presentable form

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

diff --git a/adoc/p_here.adoc b/adoc/p_here.adoc
index 116c817c34ba5281303a20b91e30d39f77cc4fb9..5a6c41609ffd4bdf8dbbe08622f609a0f8df809d 100644 (file)
--- a/adoc/p_here.adoc
+++ b/adoc/p_here.adoc
@@ -1,12 +1,20 @@
+// 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.
+
 
+.Usage example
+****
+1024 HEAP @ + HEAP ! ( allocate 1024 bytes on the heap )
+****
 
+See also <<p_allot,ALLOT>>.