Add high-level documentation for emulator: describe purpose, x86 unreal mode usage...
authorSvjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Thu, 19 Feb 2026 16:40:54 +0000 (18:40 +0200)
committerSvjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Thu, 19 Feb 2026 16:40:54 +0000 (18:40 +0200)
emulator/emulator.asm

index 3f40d61..6185e1c 100644 (file)
@@ -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