From: Svjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Date: Thu, 19 Feb 2026 16:40:54 +0000 (+0200)
Subject: Add high-level documentation for emulator: describe purpose, x86 unreal mode usage... 
X-Git-Url: http://www2.svjatoslav.eu/gitweb/?a=commitdiff_plain;h=39660cbe8e0838433bc0bd78510cdfe0cac16989;p=fifth.git

Add high-level documentation for emulator: describe purpose, x86 unreal mode usage, and memory access structure.
---

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