X-Git-Url: https://git.rrq.au/?a=blobdiff_plain;f=adoc%2Fp_plus.adoc;h=ffabee268562fa539b11f06c491afdb5c61866f5;hb=92ed95a59cba9c0685150503196877c3d81fedbc;hp=9bf9cd7210241f344b1428c916f42c878a3a13df;hpb=b7da3f7bbd1cb10241163abdb950472e539e796d;p=rrq%2Frrqforth.git

diff --git a/adoc/p_plus.adoc b/adoc/p_plus.adoc
index 9bf9cd7..ffabee2 100644
--- a/adoc/p_plus.adoc
+++ b/adoc/p_plus.adoc
@@ -1,10 +1,15 @@
+// math.asm:	WORD p_plus, '+',fasm
 
 anchor:p_plus[]
 
-Word: +
--------
+// note that asciidoc takes offence to a plain + in the title an
+// therefore we here rely an a convenince macro
+=== Word: {plus} 
 
-----
-math.asm:	WORD p_plus, '+',fasm
-----
+....
+Data stack: ( v1 v2 -- v3 )
+....
 
+"+" (plus) is a function word that replaces a pair of values with the
+result of adding them. To that end, the values are 64-bit signed
+integers.