From 39660cbe8e0838433bc0bd78510cdfe0cac16989 Mon Sep 17 00:00:00 2001
From: Svjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Date: Thu, 19 Feb 2026 18:40:54 +0200
Subject: [PATCH] Add high-level documentation for emulator: describe purpose,
 x86 unreal mode usage, and memory access structure.

---
 emulator/emulator.asm | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/emulator/emulator.asm b/emulator/emulator.asm
index 3f40d61..6185e1c 100644
--- a/emulator/emulator.asm
+++ b/emulator/emulator.asm
@@ -1,7 +1,12 @@
 ; virtual processor, emulator for FIFTH
-
+;
+; This is the x86 unreal-mode (DOS COM) program that emulates a custom
+; stack-based virtual CPU. It uses x86 unreal mode to access extended memory
+; for the virtual CPU's 4GB address space.
+;
+;
 ; registers usage:
-
+;
 ; edi - data stack pointer
 ; esi - instruction pointer
 ; es = 0
-- 
2.20.1