From e92ac02f36e97683902391b4d67f3f14d1d7b5df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?David=20Hrdli=C4=8Dka?=
 <13226155+dhrdlicka@users.noreply.github.com>
Date: Mon, 25 Aug 2025 01:25:29 +0200
Subject: [PATCH] Update macOS ROMs folder instructions

Added a warning about hidden extensions for the roms folder on macOS.
---
 usage/roms.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/usage/roms.rst b/usage/roms.rst
index cf838d1..f566000 100644
--- a/usage/roms.rst
+++ b/usage/roms.rst
@@ -36,9 +36,11 @@ This usually resolves to ``~/.local/share/86Box/roms``, ``/usr/local/share/86Box
 
 .. rubric:: macOS
 
+.. warning:: If 86Box cannot find any ROMs even after you extracted the ROM set into one of the supported directories, please make sure that the ``roms`` folder name does not contain a hidden extension. This can be fixed via the terminal, or by selecting the folder in Finder, choosing **Get Info** in the context menu or the **File** menu, and checking the *Name & Extension* section in the information window. Downloading ROM sets for stable 86Box releases from GitHub in particular may be affected by extension hiding in the Finder due to the file name format used for these.
+
 The following locations are searched on macOS:
 
-1. ``~/Library/Application Support/net.86box.86Box/roms``
-2. ``/Library/Application Support/net.86box.86Box/roms``
+1. ``~/Library/Application Support/86Box/roms``
+2. ``/Library/Application Support/86Box/roms``
 
 .. tip:: The list of all paths searched when loading ROMs is printed to the log and standard output when 86Box starts.