X-Git-Url: https://git.rrq.au/?a=blobdiff_plain;f=adoc%2Fp_dovariable.adoc;h=38c2c5e47e465f1fe248ae6194cd5a533d474b6c;hb=3615a7d1910cea3c791916293b06b757c2879be9;hp=dd27a6ef363be9af2b1e520fb0faa516da6a095e;hpb=b7da3f7bbd1cb10241163abdb950472e539e796d;p=rrq%2Frrqforth.git

diff --git a/adoc/p_dovariable.adoc b/adoc/p_dovariable.adoc
index dd27a6e..38c2c5e 100644
--- a/adoc/p_dovariable.adoc
+++ b/adoc/p_dovariable.adoc
@@ -1,9 +1,20 @@
+// rrqforth.asm:	WORD p_dovariable,'doVARIABLE',dovariable
+
 anchor:p_dovariable[]
 
-Word: doVARIABLE
-----------------
+=== Word: doVARIABLE
+
+....
+Data stack: ( -- a )
+....
+
+"doVARIABLE" is a variable word whose value is the implementation of
+the execution semantics for "variables", which basically are markers
+into the heap for some number block of memory.
+
+The execution of a variable results in pushing its content address:
+....
+Resulting data stack: ( -- a )
+....
 
-----
-rrqforth.asm:	WORD p_dovariable,'doVARIABLE',dovariable
-----