diff --git a/docs/forth_dictionary.md b/docs/forth_dictionary.md index 86762d9..e3163ac 100644 --- a/docs/forth_dictionary.md +++ b/docs/forth_dictionary.md @@ -1,6 +1,6 @@ # Forth Dictionary -Updated: 2020-01-22 17:56:07 -0800 +Updated: 2020-10-31 15:02:22 -0700 ## ! @@ -140,6 +140,12 @@ _( addr u xt -- )_ Create a DEFER definition for string with xt as its initial b _( xt -- )_ Attempt to decompile the word at xt. +## (TO) + +_( n xt | n1 n2 xt -- )_ change the first cell or two of the body of xt +if xt is a 2VALUE, change the first two cells of the body +if xt is any other created word, change the first cell of the body + ## (U.) _( u -- addr u )_ Convert u to text via pictured numeric output. @@ -357,6 +363,10 @@ _( x1 x2 -- )_ _( x1 x2 -- x1 x2 x1 x2 )_ +## 2LITERAL + +- Immediate. + ## 2OVER _( x1 x2 x3 x4 -- x1 x2 x3 x4 x1 x2 )_ @@ -381,6 +391,11 @@ _( n1 n2 -- d1 d2 )_ Convert two numbers to double-numbers. _( x1 x2 x3 x4 -- x3 x4 x1 x2 )_ +## 2VALUE + +_( n1 n2 [name< >] -- )_ Create a definition that pushes n1 and n2 on the stack, +n1 and n2 can be changed with TO. + ## 3 _( -- 3 )_ @@ -641,7 +656,7 @@ _( -- )_ ## BETWEEN -_( n1|u1 n2|u2 n3|u3 -- f )_ f = true if n2|u2 <= n1|u1 <= n3|u3, false otherwise +_( n1 n2 n3 -- f )_ f = true if n2<=n1<=n3, false otherwise ## BINARY @@ -791,8 +806,6 @@ Better to use POSTPONE in most cases. ## COMPILE, -- Immediate. - _( xt -- )_ Compile xt into the dictionary. ## CONSTANT @@ -801,7 +814,8 @@ _( n [name< >] -- )_ alias of VALUE, OF816 doesn't have true constants ## CONTEXT -_( -- wid )_ Return first wordlist in search order. +_( -- addr )_ Return address of cell with first wid in the search order. +if search order is empty, sets the search order to contain the CURRENT word list. ## CONTROL @@ -902,7 +916,7 @@ Execution: _( limit start -- )_ Start DO loop. - Immediate. - Compile-only. -_( -- )_ alter execution semantics of most recently-created definition to +_( -- )_ alter execution semantics of most recently-CREATEd definition to perform the execution semantics of the code following DOES>. ## DROP