make strncmp direction safe
[rrq/rrqforth.git] / adoc / p_dovariable.adoc
index dd27a6ef363be9af2b1e520fb0faa516da6a095e..38c2c5e47e465f1fe248ae6194cd5a533d474b6c 100644 (file)
@@ -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
-----