summary refs log tree commit diff
path: root/execution.e
diff options
context:
space:
mode:
Diffstat (limited to 'execution.e')
-rw-r--r--execution.e16
1 files changed, 11 insertions, 5 deletions
diff --git a/execution.e b/execution.e
index c3f99f2..2c8b869 100644
--- a/execution.e
+++ b/execution.e
@@ -176,7 +176,15 @@
 ~ pointer where we asked; we don't need to check what those addresses are,
 ~ because they're not randomized.
 ~
-~   This routine is really only responsible for one-time initialization.
+~   Notably, though cold-start points rbp to the control stack, it leaves
+~ the control stack empty, so trying to return will pop a value that doesn't
+~ exist, and crash. Eventually, the bottom value on the control stack will
+~ be the word "quit", which loops forever and is the closest thing Forth has
+~ to a "main" word, but it's up to warm-start to make that happen.
+~
+~   Cold-start is really only responsible for one-time initialization.
+~
+~
 ~
 ~ Registers in:
 ~
@@ -186,11 +194,9 @@
 ~
 ~ Registers out:
 ~
-~ * rsi points within "quit"
-~     Quit is the word that's Forth's closest equivalent to main().
+~ * rsi points within "warm-start"
 ~ * rsp points to the top of the value stack
-~
-~   Notably, rbp is still uninitialialized after _start.
+~ * rbp points to the top of the control stack
 ~
 ~ Stack in:
 ~