chore: merge round 5 wiki fixes

wiki/faq.md

@@ -67,12 +67,13 @@ Read them first: [install.sh](https://github.com/Abdess/retrobios/blob/main/inst
 
 ## Windows or my antivirus blocks the command
 
-Use your setup's ZIP, if any: [Get your files](../which-pack.md).
+Use your setup's ZIP. None? [Pick your consoles](../which-pack.md#only-some-consoles)
+and download their files.
 
 ## Why is there no ZIP for my setup?
 
-ZIPs are made for the setups most people download. The command installs every
-setup's files and checks each one. `--dry-run` shows the list first.
+ZIPs exist for the most downloaded setups. The command installs and checks
+every setup's files.
 
 ## Fill an SD card from a computer?
 
@@ -99,7 +100,8 @@ Fill it from a computer, as above, or point `--from-pack` at your ZIP: [Without
 
 - Name your emulator's BIOS folder with `--dest`.
 - ES-DE, LaunchBox: the command fills their emulators' folders.
-- iPhone, iPad (iOS): no terminal. Use the ZIP.
+- iPhone, iPad (iOS): no terminal.
+  [Pick your consoles and copy them to the app](../which-pack.md#iphone-and-ipad).
 
 ## Why is a file missing from the ZIP?
 

wiki/first-install.md

@@ -141,8 +141,12 @@ Choose **Another setup or folder**, then your setup and its folder.
 The message shows the command that installs Python. Run it, then run the
 installer again.
 
-A RetroPie 4.8 image has Python 3.7.3, and its update command finds nothing
-newer. Run it on a computer, the `bios` share open:
+RetroPie 4.8 has Python 3.7.3, and its update finds nothing newer. Run it on
+a computer, with RetroPie's `bios` share open, `\\RETROPIE\bios` from Windows:
+
+<!-- RetroPie-Setup scriptmodules/supplementary/samba.sh:49-52 (46128cd2) shares
+$home/RetroPie/BIOS as "bios", and RetroPie docs/Transferring-Roms.md:29 names
+\\RETROPIE. -->
 
 <!-- os-tabs windows: --platform retropie --dest \\RETROPIE\bios\ -->
 ```sh

wiki/installer.md

@@ -1,7 +1,7 @@
 ---
 level: setup
 order: 100
-terms: manifest, events, exit code, schema
+terms: manifest, events, exit code, schema, packager, pin, reproducible
 ---
 
 # All installer options
@@ -47,24 +47,21 @@ python install.py
 ### For packagers { #for-packagers }
 
 A package that must not change under its users takes the installer and its
-file list from one release. Each release carries `install.py`, `install.sh`,
-`install.ps1` and the file list of every platform (`retroarch.json` and the
-others from `install/`), all listed in the signed `SHA256SUMS.txt`:
+file list from one commit. `install.sh` of that commit pins the SHA-256 of its
+`install.py`, and `RETROBIOS_REF` makes the installer download every file from
+the same commit:
 
 ```bash
-base=https://github.com/Abdess/retrobios/releases/download/<tag>
-curl -fsSLO "$base/install.py" -O "$base/retroarch.json" -O "$base/SHA256SUMS.txt"
-sha256sum --check --ignore-missing SHA256SUMS.txt
-RETROBIOS_REF=<tag> python3 install.py --manifest retroarch.json
+commit=<commit>
+base=https://raw.githubusercontent.com/Abdess/retrobios/$commit
+curl -fsSLO "$base/install.py" -O "$base/install/retroarch.json"
+pin=$(curl -fsSL "$base/install.sh" | sed -n 's/^DEFAULT_INSTALL_SHA256="\(.*\)"$/\1/p')
+echo "$pin  install.py" | sha256sum --check
+RETROBIOS_REF=$commit python3 install.py --manifest retroarch.json
 ```
 
-For contributors: [Verifying a release](release-process.md#verifying-a-release)
-checks the signature of the list. Each release deletes the previous tag and its assets,
-so `releases/latest/download/install.py` and the other files under
-`releases/latest/download/` are the stable addresses: they serve the latest
-release, whose `SHA256SUMS.txt` names the bytes. v2026.10.10 and the releases
-before it carry neither the installer nor the file lists. What `RETROBIOS_REF`
-does not pin is listed under [Environment overrides](#environment-overrides).
+What `RETROBIOS_REF` does not pin is listed under
+[Environment overrides](#environment-overrides).
 
 ## Passing options
 

wiki/legal.md

@@ -1,6 +1,7 @@
 ---
 level: start
 order: 55
+terms: license
 ---
 
 # Is it legal?

wiki/testing-guide.md

@@ -50,14 +50,14 @@ Every module in `tests/`, by the area it guards.
 |------|----------|---------|
 | Core regression suites | synthetic | `test_e2e`, `test_audit_regressions`, `test_tool_messages` |
 | File resolution and identity | synthetic + collection | `test_adler32_resolution`, `test_agnostic_scan`, `test_agnostic_scan_mode`, `test_agnostic_scope`, `test_agnostic_substitute`, `test_archive_choice`, `test_archive_recipes`, `test_bios_companions`, `test_bundled_identity`, `test_casefold_cache`, `test_db_aliases`, `test_declared_names`, `test_derivations`, `test_directory_entries`, `test_extra_identity`, `test_foreign_tree`, `test_foreign_tree_names`, `test_frontend_digest`, `test_game_data_homonyms`, `test_hashing`, `test_identity`, `test_md5_pack_context`, `test_name_tiebreak`, `test_nec_filing`, `test_owner_resolution`, `test_path_suffix`, `test_resolution_evidence`, `test_sega_filing`, `test_shipped_content`, `test_twin_declarations`, `test_validated_choice`, `test_variant_choice`, `test_variant_identity`, `test_zipped_member` |
-| Verification, cross-reference and profile checks | synthetic + profiles | `test_bios_layout`, `test_cache_independent_counts`, `test_case_insensitive_platforms`, `test_checks_have_values`, `test_core_file_fills_declaration`, `test_core_size_refusal`, `test_cross_reference_sources`, `test_crypto_aes`, `test_crypto_unique_data`, `test_crypto_verify`, `test_entry_categories`, `test_file_consumers`, `test_fileless_audit`, `test_flycast_layout`, `test_gap_settlement`, `test_hidden_extras`, `test_launcher_aliases`, `test_launcher_layer`, `test_native_mode`, `test_no_case_collisions`, `test_path_conflict_status`, `test_path_null_copies`, `test_profile_checks`, `test_profile_repositories`, `test_romm_hash_rule`, `test_shared_groups`, `test_standalone_links`, `test_standalone_mode`, `test_undeclared_dedup`, `test_unplaced_extras`, `test_validation_scope`, `test_verify_all_dir`, `test_verify_emulator_evidence`, `test_verify_listing`, `test_verify_pack_choice`, `test_verify_release_asset` |
+| Verification, cross-reference and profile checks | synthetic + profiles | `test_bios_layout`, `test_cache_independent_counts`, `test_case_insensitive_platforms`, `test_checks_have_values`, `test_core_file_fills_declaration`, `test_core_size_refusal`, `test_cross_reference_sources`, `test_crypto_aes`, `test_crypto_unique_data`, `test_crypto_verify`, `test_entry_categories`, `test_file_consumers`, `test_fileless_audit`, `test_flycast_layout`, `test_gap_settlement`, `test_hidden_extras`, `test_launcher_aliases`, `test_launcher_layer`, `test_native_mode`, `test_no_case_collisions`, `test_path_conflict_status`, `test_path_null_copies`, `test_profile_checks`, `test_profile_names`, `test_profile_paths`, `test_profile_repositories`, `test_romm_hash_rule`, `test_shared_groups`, `test_standalone_links`, `test_standalone_mode`, `test_undeclared_dedup`, `test_unplaced_extras`, `test_validation_scope`, `test_verify_all_dir`, `test_verify_emulator_evidence`, `test_verify_listing`, `test_verify_pack_choice`, `test_verify_release_asset` |
 | Packs and manifests | synthetic + real packs | `test_artifact_lock`, `test_atomic_artifacts`, `test_batocera_cores`, `test_deterministic_zip`, `test_emulator_pack_counts`, `test_finalize_pack_names`, `test_large_file_cache`, `test_libretro_layout`, `test_manifest_entry`, `test_minui_platform`, `test_no_game_data`, `test_pack_conformance_dirs`, `test_pack_core_extras`, `test_pack_counts`, `test_pack_destinations`, `test_pack_failures`, `test_pack_file_names`, `test_pack_grouping`, `test_pack_integrity`, `test_pack_member_identity`, `test_pack_readme`, `test_platform_inheritance`, `test_platform_keys`, `test_release_packs`, `test_required_only_archives`, `test_required_only_twins`, `test_save_root`, `test_split_extras`, `test_split_names`, `test_split_pack`, `test_system_pack_extras`, `test_system_pack_parity`, `test_torrentzip`, `test_which_pack` |
 | Slots and regions | synthetic + profiles | `test_region`, `test_region_agnostic_scan`, `test_region_groups`, `test_region_held`, `test_region_platform_index`, `test_region_required_only`, `test_slot`, `test_slots`, `test_slots_shipped_file` |
 | Hardware targets and systems | synthetic + target files | `test_extract_targets`, `test_lakka_targets`, `test_libretro_slugs`, `test_system_ids`, `test_system_selection`, `test_target_names`, `test_target_scrapers`, `test_target_systems`, `test_target_verify` |
 | Installer and downloads | loopback server | `test_check_release`, `test_download`, `test_install`, `test_install_cores`, `test_install_experience`, `test_install_from`, `test_install_offline`, `test_install_selection`, `test_install_tui` |
 | Handheld launchers | a pty as the console, fake installer and firmware tools, stubbed PortMaster dialogs | `test_handheld_launchers`, `test_port` |
 | Truth and native export | synthetic + cached originals | `test_export_counts`, `test_export_native_layer`, `test_export_report`, `test_exporters`, `test_truth_data_dir_readers`, `test_truth_diff`, `test_truth_layout` |
-| Scrapers, upstream and provenance | inline sources, synthetic | `test_batocera_md5_list`, `test_check_freshness`, `test_contributing_text`, `test_coverage_cache`, `test_data_dir_refs`, `test_dataclass_defaults`, `test_dedup`, `test_doc_pages`, `test_doc_surfaces`, `test_elec_scrapers`, `test_fbneo_parser`, `test_find_pinned_revision`, `test_hash_merge`, `test_launchers`, `test_launchers_emudeck`, `test_launchers_recalbox`, `test_launchers_retrobat`, `test_launchers_retrodeck`, `test_launchers_retropie`, `test_launchers_rocknix`, `test_mame_devices`, `test_mame_parser`, `test_mame_ref_audit`, `test_optional_dependencies`, `test_profile_sync`, `test_prose_style`, `test_provenance`, `test_refresh_data_dirs`, `test_refresh_failures`, `test_refresh_stale`, `test_retrodeck_scraper_errors`, `test_romset_recipes`, `test_schema_semantic_gate`, `test_scraper_contract`, `test_site_availability`, `test_site_content_data`, `test_site_copy`, `test_site_cores`, `test_site_emulator_page`, `test_site_exports`, `test_site_funnel`, `test_site_images`, `test_site_picker`, `test_site_platform_hashes`, `test_site_r2_components`, `test_site_r2_css`, `test_site_r2_emulators`, `test_site_r2_entry`, `test_site_r2_gate`, `test_site_r2_nav`, `test_site_r2_p0`, `test_site_r2_reference`, `test_site_r2_systems`, `test_site_r2_wiki`, `test_site_r3_collection`, `test_site_r3_components`, `test_site_r3_css`, `test_site_r3_emulators`, `test_site_r3_entry`, `test_site_r3_nav`, `test_site_r3_p0`, `test_site_r3_reference`, `test_site_r3_systems`, `test_site_r3_wiki`, `test_site_r4_components`, `test_site_r4_css`, `test_site_r4_emulators`, `test_site_r4_entry`, `test_site_r4_merge`, `test_site_r4_p0`, `test_site_r4_reference`, `test_site_r4_search`, `test_site_r4_systems`, `test_site_r4_wiki`, `test_site_r5_components`, `test_site_r5_reference`, `test_site_render`, `test_site_system_links`, `test_site_validation`, `test_site_weight`, `test_site_write`, `test_source_ref_targets`, `test_upstream`, `test_upstream_index`, `test_validate_pr`, `test_validate_pr_flow`, `test_validate_pr_hashes`, `test_workflow_paths` |
+| Scrapers, upstream and provenance | inline sources, synthetic | `test_batocera_md5_list`, `test_check_freshness`, `test_contributing_text`, `test_coverage_cache`, `test_data_dir_refs`, `test_dataclass_defaults`, `test_dedup`, `test_doc_pages`, `test_doc_surfaces`, `test_elec_scrapers`, `test_fbneo_parser`, `test_find_pinned_revision`, `test_hash_merge`, `test_launchers`, `test_launchers_emudeck`, `test_launchers_recalbox`, `test_launchers_retrobat`, `test_launchers_retrodeck`, `test_launchers_retropie`, `test_launchers_rocknix`, `test_mame_devices`, `test_mame_parser`, `test_mame_ref_audit`, `test_optional_dependencies`, `test_profile_sync`, `test_prose_style`, `test_provenance`, `test_refresh_data_dirs`, `test_refresh_failures`, `test_refresh_stale`, `test_retrodeck_scraper_errors`, `test_romset_recipes`, `test_schema_semantic_gate`, `test_scraper_contract`, `test_site_availability`, `test_site_content_data`, `test_site_copy`, `test_site_cores`, `test_site_emulator_page`, `test_site_exports`, `test_site_funnel`, `test_site_images`, `test_site_picker`, `test_site_platform_hashes`, `test_site_r2_components`, `test_site_r2_css`, `test_site_r2_emulators`, `test_site_r2_entry`, `test_site_r2_gate`, `test_site_r2_nav`, `test_site_r2_p0`, `test_site_r2_reference`, `test_site_r2_systems`, `test_site_r2_wiki`, `test_site_r3_collection`, `test_site_r3_components`, `test_site_r3_css`, `test_site_r3_emulators`, `test_site_r3_entry`, `test_site_r3_nav`, `test_site_r3_p0`, `test_site_r3_reference`, `test_site_r3_systems`, `test_site_r3_wiki`, `test_site_r4_components`, `test_site_r4_css`, `test_site_r4_emulators`, `test_site_r4_entry`, `test_site_r4_merge`, `test_site_r4_p0`, `test_site_r4_reference`, `test_site_r4_search`, `test_site_r4_systems`, `test_site_r4_wiki`, `test_site_r5_components`, `test_site_r5_reference`, `test_site_r5_wiki`, `test_site_render`, `test_site_system_links`, `test_site_validation`, `test_site_weight`, `test_site_write`, `test_source_ref_targets`, `test_upstream`, `test_upstream_index`, `test_validate_pr`, `test_validate_pr_flow`, `test_validate_pr_hashes`, `test_workflow_paths` |
 
 ## Test architecture
 

wiki/troubleshooting.md

@@ -1,7 +1,7 @@
 ---
 level: start
 order: 40
-terms: bios not found, bios missing, firmware missing, bios error
+terms: bios not found, bios missing, firmware missing, bios error, check my bios folder, check bios folder
 ---
 
 # When a game does not start
@@ -33,7 +33,7 @@ Read the count line:
 
 - **`wrong hash`**: another region or model, or damaged.
 - **Fewer present than the total**: files are missing.
-- **A line under a file**, like `still zipped`, says what to fix.
+- **A line under a file**, like `still zipped`, says the fix.
 - **`0 wrong hash`, all present**: go to step 3.
 
 ## 2. Fix the files
@@ -44,11 +44,11 @@ Without `--check`, it adds missing files and replaces wrong ones.
 
 - **Right folder?** [Get your files](../which-pack.md) names it.
 - **Exact name?** `scph5501.bin` and `SCPH-5501.BIN` differ.
-- **A `bios` folder inside your BIOS folder?** Run the installer: it copies
-  those files up one level.
+- **A `bios` folder inside your BIOS folder?** The installer copies those
+  files up one level.
 - **BIOS setting on a subfolder, like `system/dc`?** Point it at the BIOS
   folder. Emulators add their own, like `dc/` for Flycast.
-- **A ZIP in parts, like `Pack.part1of2.zip`?** Unzip every part into one
+- **A ZIP in parts, like `Pack.part1of2.zip`?** Unzip all parts into one
   folder.
 
 <!-- Flycast's libretro port appends "dc/" to the system directory:
@@ -65,7 +65,7 @@ version.
 
 ## The BIOS is fine, the game still fails
 
-- **Another emulator?** Each reads its own files, listed on its page.
+- **Another emulator?** Each reads the files listed on its page.
 - **A BIOS setting?** Some emulators can skip the BIOS. In PCSX ReARMed, set
   **BIOS Selection** to **Auto**.
 - **The screen says "Please insert PlayStation CD-ROM"?** The BIOS works.
@@ -76,9 +76,14 @@ version.
 - **Network error:** try again later.
 - **`The clock reads ...`:** set the right date.
 - **Permission denied:** do what the message says.
-- **No setup found:** name it and its folder:
+- **`No supported platform detected`:** name the folder. Not sure? Open
+  RetroArch's **Settings > Directory > System/BIOS**.
 
-<!-- os-tabs windows: --platform retroarch --dest C:\path\to\RetroArch\system -->
+<!-- The folders RetroArch reads by default, as install.py writes them
+(_os_default_dests, _macos_retroarch_base) and the RetroArch setup page
+cites them. Steam Deck: the Flatpak build. -->
+
+<!-- os-tabs windows: --platform retroarch --dest C:\RetroArch-Win64\system macos: --platform retroarch --dest ~/Documents/RetroArch/system steamdeck: --platform retroarch --dest ~/.var/app/org.libretro.RetroArch/config/retroarch/system -->
 ```sh
 curl -fsSL https://raw.githubusercontent.com/Abdess/retrobios/main/install.sh | sh -s -- --platform retroarch --dest ~/.config/retroarch/system
 ```

wiki/what-are-bios-files.md

@@ -31,14 +31,15 @@ If step 3 fails, you see "BIOS missing" or a black screen.
 - **Better with it:** Dreamcast. Some games need it.
 - **Usually not:** NES, Super Nintendo, Mega Drive, Game Boy and Game Boy
   Advance.
-- **Add-ons need their own:** the Famicom Disk System and the Mega-CD.
+- **Add-ons need their own:** the Famicom Disk System and the Mega CD.
 
 Details: [Every console, one by one](../systems/index.md)
 
 ## The name must match
 
-An emulator looks for one exact name. A PlayStation emulator looks for
-`scph5501.bin`. A file with another name is not found.
+Most emulators look for one exact name, like `scph5501.bin`. A file with
+another name is not found. A few, like DuckStation, read any name and check
+what the file holds.
 
 ## The version must match