1 files changed, 10 insertions, 0 deletions

diff --git a/src/compiler.c b/src/compiler.c
index 9b6a458..98a5e7b 100644
--- a/src/compiler.c
+++ b/src/compiler.c
@@ -907,6 +907,16 @@ chunk_alloc(Chunk *parent) {
 
 CompResult
 compile_function(Chunk *chunk, Node *node) {
+    // The current activation record procedure for the VM is as follows:
+    //
+    // [caller][callee                                                ]
+    // [ .... ][ RET VAL ][ PARAMS ][ LOCALS ][ REGISTERS ][ RET META ]
+    //                    ^          
+    //                    frame pointer
+    //
+    //  The caller is responsible for allocating the return memory and the
+    //  parameter memory and filling the param data before OP_CALL.
+    //
     Chunk *func = chunk_alloc(chunk);
     func->name = node->unique_name;
     Function fun = (Function){