adding execution control words
[rrq/rrqforth.git] / adoc / p_0branch.adoc
index 16c69c0249c115ab3cddd90a70a5b8f1b1107db7..27d338d60515d9f95453d1ffff31d2ae36de97ca 100644 (file)
@@ -1,9 +1,16 @@
+// contorl.asm:        WORD p_zero_branch,'0BRANCH',fasm
+
 anchor:p_zero_branch[]
 
-Word: 0BRANCH
--------------
+=== Word: 0BRANCH
+
+....
+Data stack: ( v -- )
+....
 
-----
-rrqforth.asm:  WORD p_zero_branch,'0BRANCH',fasm
-----
+"0BRANCH" is a function word that implements execution conditional by
+means of optionally adding the subsequent branch offset, or not, to
+the point of execution. If the value, v, is 0 then the branch offset
+is added, and otherwise execution continues with the cell following
+the branch offset in the definition.