Harden mesa package for Ubuntu and Debian targets

README.md

@@ -4,6 +4,9 @@ Dieses Repo baut per Gitea Actions ein eigenständiges `mesa-git`-Paket als `.de
 Das Paket installiert Mesa separat unter `/opt/mesa-git`, damit es parallel zur
 System-Mesa genutzt werden kann.
 
+Ziel ist ein Paket, das auf `Debian 13+` sowie `Ubuntu 24.04` bis `26.x`
+installierbar bleibt.
+
 ## Was gebaut wird
 
 - Paketname: `mesa-git`
@@ -33,6 +36,11 @@ hartes Wayland-only-Build.
 Zusammen mit einem aktuellen `libdrm`-Snapshot, damit neue Mesa-Stände nicht an
 zu alten Distributionspaketen scheitern.
 
+Gebaut wird absichtlich gegen `Ubuntu 24.04` als älteste unterstützte
+Ubuntu-Basis. Zusätzlich bündelt das Paket ausgewählte Laufzeitbibliotheken
+unterhalb von `/opt/mesa-git`, damit neuere Mesa-Builds auch auf leicht
+abweichenden Debian-/Ubuntu-Systemständen starten können.
+
 ## Ablauf
 
 1. Gitea Actions startet auf dem `act_runner`.
@@ -141,6 +149,11 @@ Der Wrapper setzt die nötigen Mesa-Pfade für `LD_LIBRARY_PATH`,
 `LIBGL_DRIVERS_PATH`, `VK_LAYER_PATH` und `VK_ICD_FILENAMES`.
 Vorhandene Vulkan-ICDs aus dem Paket werden dabei automatisch eingesammelt.
 
+Wichtig: Prüfungen für die isolierte Installation sollten ebenfalls über
+`mesa-git-env` laufen. Ein rohes `ldd` direkt auf Bibliotheken unter
+`/opt/mesa-git` kann sonst fälschlich fehlende Abhängigkeiten zeigen, obwohl
+der Wrapper die Laufzeitpfade korrekt setzt.
+
 ## Lokaler Test
 
 Mit installierten Build-Abhängigkeiten:
@@ -149,6 +162,10 @@ Mit installierten Build-Abhängigkeiten:
 ./scripts/build-mesa-opt.sh
 ```
 
+Für einen sauberen Kompatibilitätstest lohnt sich ein isolierter Container oder
+eine `distrobox` mit eigenem temporären `HOME`, damit Build-Artefakte,
+Paketquellen und Caches danach vollständig wieder entfernt werden können.
+
 ## Anpassen
 
 Die wichtigsten Schalter liegen in `config/mesa-opt.conf`: