docs: explain why the pack leaves a file out

A file the emulator installs itself is left out of the packs, per build and per platform. The profiling guide documents bundled, installed_on and not_bundled_on, the FAQ says why a file the emulator reads may be missing from a pack, and an emulator page names the build that installs it and the platforms whose package differs.
This commit is contained in:
Abdessamad Derraz committed 2026-10-20 06:24:18 +02:00
1 parent f6ac473e78
commit 4227aee9b4
4 files changed
+35 -2

No files matched your search

+10 -1
View File
@@ -2677,8 +2677,11 @@ def _file_badges(f: dict, in_repo: bool) -> list[str]:
f'<span class="rb-badge rb-badge-muted">{storage}</span>'
)
if bundled:
# Said in words: the pack leaves the file out because the emulator,
# in the build the entry names, already installs it.
build = f" {f['mode']}" if f.get("mode") in ("standalone", "libretro") else ""
badges.append(
'<span class="rb-badge rb-badge-muted">bundled</span>'
f'<span class="rb-badge rb-badge-muted">installed with the{build} emulator</span>'
)
if embedded:
badges.append(
@@ -2832,6 +2835,12 @@ def _render_emulator_file(
elif isinstance(validation, dict):
for scope, checks in validation.items():
details.append(f"Validation ({scope}): {', '.join(checks)}")
if f.get("installed_on"):
details.append("Installed by the platform's own package on: "
+ ", ".join(sorted(f["installed_on"])))
if f.get("not_bundled_on"):
details.append("Left out by the platform's package, so the pack brings it, on: "
+ ", ".join(sorted(f["not_bundled_on"])))
if source_ref:
asker = requested_by(profile, source_ref)
if asker: