From e660022628a71d1c805daea88ffb6e312c6a56c0 Mon Sep 17 00:00:00 2001
From: Abdessamad Derraz <3028866+Abdess@users.noreply.github.com>
Date: Sun, 18 Oct 2026 07:41:12 +0200
Subject: [PATCH] docs: say why openlara reads nothing it is given

OpenLara asks for the system directory to keep its own shader and cache
files under openlara/cache, which it writes and reads back itself.
---
 emulators/openlara.yml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/emulators/openlara.yml b/emulators/openlara.yml
index 5c5a8c05..7946ae9f 100644
--- a/emulators/openlara.yml
+++ b/emulators/openlara.yml
@@ -10,6 +10,12 @@ display_name: "Tomb Raider (OpenLara)"
 cores: [openlara]
 systems: [tomb-raider]
 verification: existence
+exclusion_note: >
+  The system directory holds openlara/cache, which the core creates
+  (src/platform/libretro/main.cpp:177-196) and fills with the shader program
+  binaries and cache streams it writes itself, read back only as a cache
+  (src/gapi/gl.h:810-816, src/utils.h:2361-2367). Nothing in it is supplied by
+  the user.
 notes: >
   Open-source reimplementation of the classic Tomb Raider engine (TR1-TR4).
   Accepts phd|psx|tr2|sat extensions (src/platform/libretro/main.cpp:246). need_fullpath is true -