From b06c16618cc58ea0cf818ccc642e3bc252d71189 Mon Sep 17 00:00:00 2001
From: Abdessamad Derraz <3028866+Abdess@users.noreply.github.com>
Date: Fri, 23 Oct 2026 18:49:11 +0200
Subject: [PATCH] docs: add data_root to dosbox-staging

---
 emulators/dosbox-staging.yml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/emulators/dosbox-staging.yml b/emulators/dosbox-staging.yml
index bcc71381..ffb37411 100644
--- a/emulators/dosbox-staging.yml
+++ b/emulators/dosbox-staging.yml
@@ -17,6 +17,20 @@ systems:
   - tandy-1000
 mode: standalone
 
+data_root:
+  windows:
+    path: "%LOCALAPPDATA%/DOSBox"
+    source_ref: "src/misc/cross.cpp:67-101"
+    note: "dosbox-staging.conf beside the executable makes that folder the root instead"
+  macos:
+    path: "~/Library/Preferences/DOSBox"
+    source_ref: "src/misc/cross.cpp:54-63"
+    note: "dosbox-staging.conf beside the executable makes that folder the root instead"
+  linux:
+    path: "$XDG_CONFIG_HOME/dosbox"
+    source_ref: "src/misc/cross.cpp:108-171, src/misc/fs_utils_posix.cpp:100-105"
+    note: "~/.config/dosbox when XDG_CONFIG_HOME is unset, ~/.dosbox when that folder cannot be used. dosbox-staging.conf beside the executable makes that folder the root instead"
+
 notes: |
   Continuation of DOSBox on a C++23 codebase, SDL3, libmt32emu and FluidSynth
   from vcpkg. The machine setting selects a video adapter (hercules, cga,