From 20c715fadda8f5966764b0a3ff99b1e5f8a38bb7 Mon Sep 17 00:00:00 2001
From: Elaina Claus <elaina.claus@chtm.me>
Date: Sun, 7 Sep 2025 13:15:40 -0400
Subject: [PATCH] update notes on unreal entry

---
 src/stage2/stage2.nasm | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/stage2/stage2.nasm b/src/stage2/stage2.nasm
index 360641d..a13ebd1 100755
--- a/src/stage2/stage2.nasm
+++ b/src/stage2/stage2.nasm
@@ -171,7 +171,10 @@ main:
     call GetMemoryMap
     print_string MemoryMap_OK_info
 
-    ; enter unreal mode (16 bit code, 32 bit flat memory model)
+    ; enter unreal mode (enter PM w/ 16 bit code, 32 bit flat memory model & return to real)
+    ; ds, es will be set to the 64KiB STAGE2_SEGMENT, fs/gs will be flat/huge memory (4GiB)
+    ; use __REFLAT macros to re-flat ds/es for easy transfers to >1MiB
+    ; NOTE: if you modify a segment register you will need to re-unreal it
     call EnterUnrealMode
     print_string UnrealMode_OK_info