kmoody/libretro
1
0
Fork 0
mirror of https://github.com/Abdess/retroarch_system.git synced 2026-04-13 12:22:33 -05:00
Code Issues Packages Projects Releases Wiki Activity

docs: add granular pack options to tools reference

Browse Source
This commit is contained in:
Abdessamad Derraz
2026-03-28 09:29:31 +01:00
parent 2666ebd9b7
commit f1855641c5
2 changed files with 42 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
scripts/generate_site.py
View File

@@ -1604,10 +1604,22 @@ def generate_wiki_tools() -> str:
"Build platform-specific BIOS ZIP packs.", "Build platform-specific BIOS ZIP packs.",
"", "",
"```bash", "```bash",
"# Full platform packs",
"python scripts/generate_pack.py --all --output-dir dist/", "python scripts/generate_pack.py --all --output-dir dist/",
"python scripts/generate_pack.py --platform batocera", "python scripts/generate_pack.py --platform batocera",
"python scripts/generate_pack.py --emulator dolphin", "python scripts/generate_pack.py --emulator dolphin",
"python scripts/generate_pack.py --system atari-lynx", "python scripts/generate_pack.py --system atari-lynx",
"",
"# Granular options",
"python scripts/generate_pack.py --platform retroarch --system sony-playstation",
"python scripts/generate_pack.py --platform batocera --required-only",
"python scripts/generate_pack.py --platform retroarch --split",
"python scripts/generate_pack.py --platform retroarch --split --group-by manufacturer",
"",
"# Hash-based lookup and custom packs",
"python scripts/generate_pack.py --from-md5 d8f1206299c48946e6ec5ef96d014eaa",
"python scripts/generate_pack.py --platform batocera --from-md5-file missing.txt",
"python scripts/generate_pack.py --platform retroarch --list-systems",
"```", "```",
"", "",
"Packs include platform baseline files plus files required by the platform's cores.", "Packs include platform baseline files plus files required by the platform's cores.",
@@ -1615,6 +1627,15 @@ def generate_wiki_tools() -> str:
"the tool searches for a variant that satisfies both.", "the tool searches for a variant that satisfies both.",
"If none exists, the platform version is kept and the discrepancy is reported.", "If none exists, the platform version is kept and the discrepancy is reported.",
"", "",
"**Granular options:**",
"",
"- `--system` with `--platform`: filter to specific systems within a platform pack",
"- `--required-only`: exclude optional files, keep only required",
"- `--split`: generate one ZIP per system instead of one big pack",
"- `--split --group-by manufacturer`: group split packs by manufacturer (Sony, Nintendo, Sega...)",
"- `--from-md5`: look up a hash in the database, or build a custom pack with `--platform`/`--emulator`",
"- `--from-md5-file`: same, reading hashes from a file (one per line, comments with #)",
"",
"### cross_reference.py", "### cross_reference.py",
"", "",
"Compare emulator profiles against platform configs.", "Compare emulator profiles against platform configs.",

21
wiki/tools.md
View File

@@ -51,10 +51,22 @@ Verification modes per platform:
Build platform-specific BIOS ZIP packs. Build platform-specific BIOS ZIP packs.
```bash ```bash
# Full platform packs
python scripts/generate_pack.py --all --output-dir dist/ python scripts/generate_pack.py --all --output-dir dist/
python scripts/generate_pack.py --platform batocera python scripts/generate_pack.py --platform batocera
python scripts/generate_pack.py --emulator dolphin python scripts/generate_pack.py --emulator dolphin
python scripts/generate_pack.py --system atari-lynx python scripts/generate_pack.py --system atari-lynx
# Granular options
python scripts/generate_pack.py --platform retroarch --system sony-playstation
python scripts/generate_pack.py --platform batocera --required-only
python scripts/generate_pack.py --platform retroarch --split
python scripts/generate_pack.py --platform retroarch --split --group-by manufacturer
# Hash-based lookup and custom packs
python scripts/generate_pack.py --from-md5 d8f1206299c48946e6ec5ef96d014eaa
python scripts/generate_pack.py --platform batocera --from-md5-file missing.txt
python scripts/generate_pack.py --platform retroarch --list-systems
``` ```
Packs include platform baseline files plus files required by the platform's cores. Packs include platform baseline files plus files required by the platform's cores.
@@ -62,6 +74,15 @@ When a file passes platform verification but fails emulator validation,
the tool searches for a variant that satisfies both. the tool searches for a variant that satisfies both.
If none exists, the platform version is kept and the discrepancy is reported. If none exists, the platform version is kept and the discrepancy is reported.
**Granular options:**
- `--system` with `--platform`: filter to specific systems within a platform pack
- `--required-only`: exclude optional files, keep only required
- `--split`: generate one ZIP per system instead of one big pack
- `--split --group-by manufacturer`: group split packs by manufacturer (Sony, Nintendo, Sega...)
- `--from-md5`: look up a hash in the database, or build a custom pack with `--platform`/`--emulator`
- `--from-md5-file`: same, reading hashes from a file (one per line, comments with #)
### cross_reference.py ### cross_reference.py
Compare emulator profiles against platform configs. Compare emulator profiles against platform configs.