some macros

1 files changed, 18 insertions, 0 deletions

diff --git a/readme.md b/readme.md
index 2eb22a7..56a31fe 100644
--- a/readme.md
+++ b/readme.md
@@ -12,6 +12,7 @@ for amd64 linux systems.
 - `?`: boolean flag
 
 ## 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)
 
 ### `dp   ( -- a )`
@@ -20,3 +21,20 @@ the following is a list of words available in this forth. (neither of these have
 ### `here   ( -- a )`
 `here` yields the address of the first available byte
 in user memory.
+
+## dictionary format
+
+note that the string length of one byte limits a word's name to 255 characters.
+
+| field | size |
+| :---- | :--- |
+| link to previous word | 8 bytes |
+| flag field | 1 byte |
+| string length | 1 byte |
+| string | <256 bytes |
+| code | variable length |
+
+## reserved registers
+
+the registers `r14` and `r15` are reserved for the parameter stack
+and the top of stack respectively.