docs: read voxatron files from its binaries

vox.dat is fatal when absent; libHoloPlayCore.so is never linked, named or opened by vox or vox_dyn, so it is optional.
This commit is contained in:
Abdessamad Derraz committed 2026-11-09 16:33:41 +01:00
1 parent 80a3139a19
commit 934dd4c0f9
1 file changed
+8 -7
+8 -7
View File
@@ -189,27 +189,28 @@ files:
required: true
description: "Voxatron main executable"
source_ref: "batocera lexaloffleGenerator.py:20, 42, 48-52"
note: "Configgen checks existence and executable permission. x86_64 only."
note: "The Voxatron program, an x86_64 ELF with SDL2 linked in. Batocera's generator runs bios/voxatron/vox and raises when it is missing or not executable."
- name: vox_dyn
path: voxatron/vox_dyn
system: voxatron
required: false
description: "Voxatron dynamically linked executable"
source_ref: "batocera lexaloffleGenerator.py:20, 42"
note: "Alternative to vox. Requires system SDL2."
source_ref: "voxatron vox_dyn, NEEDED libSDL2-2.0.so.0, batocera lexaloffleGenerator.py:20, 42"
note: "The same program linked against the system SDL2 (its only extra NEEDED library). Batocera's generator never runs it."
- name: vox.dat
path: voxatron/vox.dat
system: voxatron
required: true
description: "Voxatron data file"
note: "Loaded by vox/vox_dyn from same directory at startup."
source_ref: "voxatron vox, string vox.dat at 0x2a58f, voxatron vox_dyn, string vox.dat at 0x1f1af"
note: "Opened from the folder of the binary that runs. Absent, vox stops with \"FATAL ERROR: could not load vox.dat\"."
- name: libHoloPlayCore.so
path: voxatron/libHoloPlayCore.so
system: voxatron
required: true
required: false
description: "Looking Glass holographic display support library"
source_ref: "batocera lexaloffleGenerator.py:41, 87-90"
note: "Compile-time linked dependency. LD_LIBRARY_PATH set to bios/voxatron/ by configgen."
source_ref: "voxatron vox, voxatron vox_dyn, batocera lexaloffleGenerator.py:41, 87-90"
note: "Neither binary links it or names it, and neither opens it in a run (strace, with and without the file). Batocera's generator sets LD_LIBRARY_PATH to bios/voxatron, where it keeps the library."