some basic words and documentation thereof

i Will™ maintain the documentation alongside the code

1 files changed, 42 insertions, 4 deletions

diff --git a/readme.md b/readme.md
index 56a31fe..46112f3 100644
--- a/readme.md
+++ b/readme.md
@@ -13,14 +13,52 @@ for amd64 linux systems.
 
 ## Glossary
 
-the following is a list of words available in this forth. (neither of these have been implemented yet i'm just putting them here in the meantime lol)
+the following is a list of words available in this forth.
+
+### `#tib   ( -- a )`
+variable containing the amount of characters in the input buffer.
+
+### `>in   ( -- a )`
+variable containing the index of the first unparsed character
+in the input buffer.
+
+### `brk@   ( -- a )`
+yields current program break.
+
+### `bye   ( -- )`
+exits the forth system.
 
 ### `dp   ( -- a )`
-`dp` is a variable that contains the lowest free byte of memory in user memory.
+a variable that contains the lowest free byte of memory in user memory.
+
+### `dp0   ( -- )`
+a variable that contains the first byte of user memory.
+
+### `dp$   ( -- )`
+a variable that contains the last available byte of user memory.
+
+### `executable   ( u a -- )`
+marks the u bytes starting at address a as executable.
+this is used primarily to mark the program break,
+which is used as the user memory space.
+
+### `grow   ( u -- )`
+grows the user memory space by u bytes.
 
 ### `here   ( -- a )`
-`here` yields the address of the first available byte
-in user memory.
+yields the address of the first available byte in user memory.
+
+### `latest   ( -- a )`
+a variable containing the execution token of
+the most recently created word.
+
+### `state   ( -- a )`
+a variable containing a boolean value.
+if 0 (false), the system is in interpreting mode,
+if -1 (true), the system is in compiling mode.
+
+### `tib   ( -- a )`
+a variable containing the address of the current input buffer.
 
 ## dictionary format