From 90262751c02c0a267f6c754b728c6802d0acaca1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Remko=20Tron=C3=A7on?= <remko@el-tramo.be>
Date: Sat, 28 May 2022 21:50:03 +0200
Subject: [PATCH] Add documentation

---
 src/waforth.wat | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/waforth.wat b/src/waforth.wat
index d77e66f..dc25a06 100644
--- a/src/waforth.wat
+++ b/src/waforth.wat
@@ -2069,6 +2069,13 @@
 
   ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
   ;; Compiler functions
+  ;;
+  ;; `compileXXXX` functions compile Forth words. These are mostly defined in terms of
+  ;; several lower level `emitXXXX` functions.
+  ;;
+  ;; `emitXXXX` words are low level functions that emit a single WebAssembly 
+  ;; instruction in binary format. This is a direct translation from the WebAssembly
+  ;; spec.
   ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 
   ;; Initializes compilation.