docs: shorten two script docstrings

_enrich_hashes repeated "ground truth" five times with capitalised
insistence for a three-step lookup, and the MAME ZIP rebuild listed
three guarantees of which two were the same.
This commit is contained in:
Abdessamad Derraz committed 2026-10-21 05:24:34 +02:00
1 parent 82d5ff77cf
commit 76618af460
3 files changed
+25 -29

No files matched your search

+3 -9
View File
@@ -1252,16 +1252,10 @@ class DamagedArchiveError(OSError):
def _normalize_zip_for_pack(
source_zip: str, dest_path: str, target_zf: zipfile.ZipFile
) -> None:
"""Add a MAME BIOS ZIP to the pack as a deterministic rebuild.
"""Add a MAME BIOS ZIP to the pack, rebuilt from its ROMs.
Instead of copying the original ZIP (with non-deterministic metadata),
extracts the ROM atoms, rebuilds the ZIP deterministically, and writes
the normalized version into the pack.
This ensures:
- Same ROMs -> same ZIP hash in every pack build
- No dependency on how the user built their MAME ROM set
- Bit-identical ZIPs across platforms and build times
The same ROMs give the same archive bytes in every build, whatever
metadata the source ZIP carried.
"""
import tempfile as _tmp