X-Git-Url: https://git.rrq.au/?a=blobdiff_plain;f=adoc%2Fp_roll.adoc;h=a4d4419967d281e02f25acdda91aa04f68bc6388;hb=bd57eebaf0e27546c2e99602d068954aa00920b8;hp=79083f26a9dda91f03e3538ee406ba3d56aa81ab;hpb=b7da3f7bbd1cb10241163abdb950472e539e796d;p=rrq%2Frrqforth.git

diff --git a/adoc/p_roll.adoc b/adoc/p_roll.adoc
index 79083f2..a4d4419 100644
--- a/adoc/p_roll.adoc
+++ b/adoc/p_roll.adoc
@@ -1,9 +1,19 @@
+// stack.asm:	WORD p_roll, 'ROLL',fasm
+
 anchor:p_roll[]
 
-Word: ROLL
-----------
+=== Word: ROLL
+
+....
+Data stack: ( vu...v1 v0 u -- ...v1 v0 vu )
+....
+
+"ROLL" is a function word that "moves" the u:th data stack cell down
+from top onto the data stack while discarding it. 0 indicates the top
+cell; 1 indicates the second top cell making it the same as
+<<p_swap,SWAP>>; 2 indicates the third top cell making it the same as
+<<p_rot,ROT>>.
+
+
 
-----
-stack.asm:	WORD p_roll, 'ROLL',fasm
-----