chore: point seven profiles' refs at their values

emulators/idtech4a++.yml

@@ -238,9 +238,11 @@ files:
     description: "SoundFont for the MIDI devices"
     note: >-
       Collected by scanning a `soundfonts` directory added to the search paths of
-      the config file; every .sf2 and zipped GUS patch set found there becomes a
+      the config file (Q3E/src/main/jni/zdoom/src/gameconfigfile.cpp:220, 258);
-      menu entry.
+      every .sf2 and zipped GUS patch set found there becomes a menu entry.
-    source_ref: "Q3E/src/main/jni/zdoom/src/gameconfigfile.cpp:220, 258, Q3E/src/main/jni/zdoom/src/common/audio/music/i_soundfont.cpp:335-370"
+      fluid_patchset defaults to GAMENAMELOWERCASE, "uzdoom", which
+      FindSoundFont matches against the file base name.
+    source_ref: "Q3E/src/main/jni/zdoom/src/version.h:110, Q3E/src/main/jni/zdoom/src/common/audio/music/music_config.cpp:119, Q3E/src/main/jni/zdoom/src/common/audio/music/i_soundfont.cpp:335-370, 458-468"
 
   - name: GENMIDI.GS.wopl
     required: false
@@ -280,12 +282,12 @@ files:
     description: "ECWolf engine resource archive"
     note: >-
       Named by MAIN_PK3 and passed to the game selector with the program
-      directory; failing to open it ends the process with "Could not open
+      directory (Q3E/src/main/jni/ecwolf/src/wl_main.cpp:1294-1307); failing
-      ecwolf.pk3!". It holds the IWADINFO rules that identify which Wolfenstein
+      to open it ends the process with "Could not open ecwolf.pk3!". It holds the IWADINFO rules that identify which Wolfenstein
       data set is present, the palettes and the actor definitions. This build
       reads it from disk after extraction, unlike the libretro core which
       compiles it in.
-    source_ref: "Q3E/src/main/jni/ecwolf/src/version.h:12, Q3E/src/main/jni/ecwolf/src/wl_iwad.cpp:604, Q3E/src/main/jni/ecwolf/src/wl_main.cpp:1294-1307, Q3E/src/main/java/com/n0n3m4/q3e/Q3EPatchResourceManager.java:186-195"
+    source_ref: "Q3E/src/main/jni/ecwolf/src/version.h:12, Q3E/src/main/jni/ecwolf/src/wl_iwad.cpp:604, Q3E/src/main/java/com/n0n3m4/q3e/Q3EPatchResourceManager.java:186-195"
 
   - name: glprogs.pk4
     required: true
@@ -403,7 +405,7 @@ files:
       Unpacked into `files/` under the Source standalone directory. It carries
       the DejaVu, Droid Sans Fallback, Itim and Liberation faces the engine
       substitutes for the Windows fonts, and extras_dir.vpk.
-    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EPatchResourceManager.java:164-173, Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:938-961, Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameConstants.java:396"
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EPatchResourceManager.java:164-173, Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:938-961, Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameConstants.java:383, 396"
 
   - name: d3_sabot_a7.pk4
     required: false

emulators/msx-emu.yml

@@ -254,7 +254,7 @@ files:
     size: 408
     sha1: "483b2c34fcb3ddcf650314e45104f358ef74c98b"
     description: "MSX1 machine definition"
-    source_ref: "MSX.emu/src/blueMSX/Board/Machine.c:300-339,450-468, MSX.emu/src/main/RomLoader.cc:135-144, MSX.emu/src/main/system.ccm:75-76, MSX.emu/src/main/EmuMenuViews.cc:32-97"
+    source_ref: "MSX.emu/src/blueMSX/Board/Machine.c:300-339,450-468, MSX.emu/src/main/RomLoader.cc:135-144, MSX.emu/src/main/EmuMenuViews.cc:32-97"
 
   - name: "config.ini"
     path: "Machines/MSX2/config.ini"
@@ -264,7 +264,8 @@ files:
     size: 649
     sha1: "460ded0dbfc0285490da87a446b0321b6496aa5b"
     description: "MSX2 machine definition, the default MSX machine"
-    source_ref: "MSX.emu/src/blueMSX/Board/Machine.c:300-339,450-468, MSX.emu/src/main/RomLoader.cc:135-144, MSX.emu/src/main/system.ccm:75-76, MSX.emu/src/main/EmuMenuViews.cc:32-97"
+    note: "Default of the machine name option (MSX.emu/src/main/system.ccm:75)."
+    source_ref: "MSX.emu/src/blueMSX/Board/Machine.c:300-339,450-468, MSX.emu/src/main/RomLoader.cc:135-144, MSX.emu/src/main/EmuMenuViews.cc:32-97"
 
   - name: "config.ini"
     path: "Machines/MSX2+/config.ini"
@@ -274,7 +275,7 @@ files:
     size: 773
     sha1: "cb7d14a17c4f4632f17ba5a64160cdd876dd6010"
     description: "MSX2+ machine definition"
-    source_ref: "MSX.emu/src/blueMSX/Board/Machine.c:300-339,450-468, MSX.emu/src/main/RomLoader.cc:135-144, MSX.emu/src/main/system.ccm:75-76, MSX.emu/src/main/EmuMenuViews.cc:32-97"
+    source_ref: "MSX.emu/src/blueMSX/Board/Machine.c:300-339,450-468, MSX.emu/src/main/RomLoader.cc:135-144, MSX.emu/src/main/EmuMenuViews.cc:32-97"
 
   - name: "config.ini"
     path: "Machines/MSXturboR/config.ini"
@@ -284,7 +285,7 @@ files:
     size: 941
     sha1: "9836d109ec7879374dcd044da149f1b5aafd4664"
     description: "MSX turbo R machine definition"
-    source_ref: "MSX.emu/src/blueMSX/Board/Machine.c:300-339,450-468, MSX.emu/src/main/RomLoader.cc:135-144, MSX.emu/src/main/system.ccm:75-76, MSX.emu/src/main/EmuMenuViews.cc:32-97"
+    source_ref: "MSX.emu/src/blueMSX/Board/Machine.c:300-339,450-468, MSX.emu/src/main/RomLoader.cc:135-144, MSX.emu/src/main/EmuMenuViews.cc:32-97"
 
   - name: "config.ini"
     path: "Machines/COL - ColecoVision/config.ini"
@@ -294,7 +295,8 @@ files:
     size: 347
     sha1: "0f0b7b73ba6f8677dfc5c824bb3edf6df2ff653e"
     description: "ColecoVision machine definition, the default Coleco machine"
-    source_ref: "MSX.emu/src/blueMSX/Board/Machine.c:300-339,450-468, MSX.emu/src/main/RomLoader.cc:135-144, MSX.emu/src/main/system.ccm:75-76, MSX.emu/src/main/EmuMenuViews.cc:32-97"
+    note: "Default of the machine name option (MSX.emu/src/main/system.ccm:76)."
+    source_ref: "MSX.emu/src/blueMSX/Board/Machine.c:300-339,450-468, MSX.emu/src/main/RomLoader.cc:135-144, MSX.emu/src/main/EmuMenuViews.cc:32-97"
 
   - name: "MSX.rom"
     path: "Machines/Shared Roms/MSX.rom"

emulators/neo-emu.yml

@@ -261,8 +261,9 @@ files:
       Named in the audio BIOS region by irrmaze, neogeo, svcboot, svcplus,
       svcplusa and svcsplus, and reached in this archive by the parent lookup of
       irrmaze. The region is exempt from the fatal path and the buffer it lands
-      in is never read by the emulation.
+      in is never read by the emulation
-    source_ref: "NEO.emu/res/romsets/irrmaze.drv, NEO.emu/src/gngeo/roms.c:1034-1039,1413-1418,1440-1461, NEO.emu/src/gngeo/roms.h:63"
+      (NEO.emu/src/gngeo/roms.c:1034-1039,1413-1418,1440-1461).
+    source_ref: "NEO.emu/res/romsets/irrmaze.drv, NEO.emu/src/gngeo/roms.h:9,62"
 
   - name: "gngeo_data.zip"
     system: snk-neogeo-mvs

emulators/nuance.yml

@@ -61,9 +61,10 @@ files:
     md5: "23bf80c259f182f582beeb368aba98f5"
     required: true
     bundled: true
-    source_ref: "src/libretro.cpp:332-371, src/NuonEnvironment.cpp:595, src/NuonEnvironment.cpp:617-619, src/bios.cpp:566-582, src/coff.cpp:47-70"
+    source_ref: "src/libretro.cpp:332-371, src/NuonEnvironment.cpp:595, src/NuonEnvironment.cpp:617-619, src/bios.cpp:566-582"
     note: >
-      Loaded into MPE3 by InitBios. The 2007 build shipped in the release
+      Loaded into MPE3 by InitBios through LoadCoffFile, which rejects a file
+      whose magic is not 0x0120 (src/coff.cpp:47-71). The 2007 build shipped in the release
       archives (19410 bytes, sha1 4f42ed8f5e171cc79112d1c1e201381e83b1fc0d)
       loads the same way.
 

emulators/super3.yml

@@ -132,11 +132,11 @@ files:
       name and crc32 of every file that fills them, the stepping, the PCI bridge, the
       encryption key, the drive board, net board and MPEG board the machine carries, the
       patches to apply and the parent set to fall back on. Handed to the GameLoader
-      constructor, parsed as XML, and a game load is refused outright when the file is
+      constructor, parsed as XML (Src/GameLoader.cpp:492-502, 930-933), and a game
-      not there. The Kotlin launcher parses the same copy out of the assets for its game
+      load is refused outright when the file is not there. The Kotlin launcher parses the same copy out of the assets for its game
       list and its per-game input hints. Byte identical to the copy in the repository
       root Config directory.
-    source_ref: "android/app/src/main/cpp/native-lib.cpp:568-580, 1096-1114, Src/GameLoader.cpp:492-502, 930-933, Src/Util/ConfigBuilders.cpp:60-73, android/app/src/main/java/com/izzy2lost/super3/GameXml.kt:23-24, android/app/src/main/java/com/izzy2lost/super3/MainActivity.kt:1211"
+    source_ref: "android/app/src/main/cpp/native-lib.cpp:568-580, 1096-1114, Src/Util/ConfigBuilders.cpp:60-73, android/app/src/main/java/com/izzy2lost/super3/GameXml.kt:23-24, android/app/src/main/java/com/izzy2lost/super3/MainActivity.kt:1211"
 
   - name: Supermodel.ini
     path: "Config/Supermodel.ini"

emulators/supermodel.yml

@@ -93,8 +93,8 @@ files:
     sha1: "6871a47de90ca67f9ff8e4e280416851a8164563"
     md5: "0c7cfc0cba2f2cd674d94e093936f9f8"
     description: "ROM set definitions"
-    note: "Parsed at startup into the game database. Every ROM region, file name and CRC32 the loader matches against comes from here, so an unreadable file leaves no set to resolve and the launch returns before the emulator is built. The path is a config key, so -game-xml-file moves it. Nothing about the file is verified beyond parsing; the hash is that of the copy the pinned revision ships."
+    note: "Parsed at startup into the game database (Src/GameLoader.cpp:549-559, 1014-1017). Every ROM region, file name and CRC32 the loader matches against comes from here, so an unreadable file leaves no set to resolve and the launch returns before the emulator is built. The path is a config key, so -game-xml-file moves it. Nothing about the file is verified beyond parsing; the hash is that of the copy the pinned revision ships."
-    source_ref: "Src/OSD/SDL/Main.cpp:117, Src/OSD/SDL/Main.cpp:1500, Src/OSD/SDL/Main.cpp:1957, Src/OSD/SDL/Main.cpp:2319-2329, Src/GameLoader.cpp:549-559, Src/GameLoader.cpp:1014-1017"
+    source_ref: "Src/OSD/SDL/Main.cpp:117, Src/OSD/SDL/Main.cpp:1500, Src/OSD/SDL/Main.cpp:1957, Src/OSD/SDL/Main.cpp:2319-2329"
 
   - name: Games.xml
     path: "supermodel/Games.xml"
@@ -110,8 +110,8 @@ files:
       - "2d16307ceb658636a05d34c7ba935b48"
       - "29fd5bc40cea222e040c1a1cfd60ea2e"
     description: "ROM set definitions, libretro copy"
-    note: "Read through the VFS from {system}/supermodel/Games.xml, or Config/Games.xml under it, and parsed from memory. When the read yields nothing the bytes compiled in from Config/Games.xml are parsed instead, so the core identifies every set without a file on disk; a file that is present takes precedence. The second hash is the embedded array, which predates the indentation cleanup of the repository copy by one tab."
+    note: "Read through the VFS from {system}/supermodel/Games.xml, or Config/Games.xml under it, and parsed from memory (Src/GameLoader.cpp:1019-1030). When the read yields nothing the bytes compiled in from Config/Games.xml are parsed instead, so the core identifies every set without a file on disk; a file that is present takes precedence. The second hash is the embedded array, which predates the indentation cleanup of the repository copy by one tab."
-    source_ref: "Src/OSD/libretro/LibretroWrapper.cpp:187-206, Src/OSD/libretro/LibretroWrapper.cpp:221-222, Src/OSD/libretro/LibretroWrapper.cpp:822, Src/OSD/libretro/LibretroWrapper.cpp:834-859, Src/GameLoader.cpp:1019-1030, Makefile:651-653"
+    source_ref: "Src/OSD/libretro/LibretroWrapper.cpp:187-206, Src/OSD/libretro/LibretroWrapper.cpp:221-222, Src/OSD/libretro/LibretroWrapper.cpp:822, Src/OSD/libretro/LibretroWrapper.cpp:834-859, Makefile:651-653"
 
   - name: Supermodel.ini
     path: "supermodel/Supermodel.ini"

emulators/yaps2.yml

@@ -458,10 +458,11 @@ files:
     sha1: 0a16f66d7816d73af3b28dea2bb292415695f6f7
     description: "Vulkan texture function shader"
     note: >-
-      Read into the device at creation and specialised per draw. A source
+      Read from the resources directory into the device at creation
-      that cannot be read fails GSDeviceVK::Create, and Vulkan is the backend
+      (pcsx2/GS/Renderers/Common/GSDevice.cpp:372-375) and specialised per
-      the libretro core presents through.
+      draw. A source that cannot be read fails GSDeviceVK::Create, and Vulkan
-    source_ref: "pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:2308-2317, pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:5349-5364, pcsx2/GS/Renderers/Common/GSDevice.cpp:372-375"
+      is the backend the libretro core presents through.
+    source_ref: "pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:2308-2317, pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:5349-5364"
 
   - name: convert.glsl
     path: pcsx2/resources/shaders/vulkan/convert.glsl
@@ -828,7 +829,7 @@ files:
       Named as the placeholder texture when the fullscreen interface
       initialises; that initialisation fails without it and the interface
       stays closed.
-    source_ref: "pcsx2/ImGui/FullscreenUI.cpp:335-341, pcsx2/ImGui/ImGuiFullscreen.cpp:292-300"
+    source_ref: "pcsx2/ImGui/FullscreenUI.cpp:335-341, pcsx2/ImGui/ImGuiFullscreen.cpp:216-226, 292-300"
 
   - name: no-save.png
     path: pcsx2/resources/fullscreenui/no-save.png
@@ -1381,7 +1382,8 @@ files:
     size: 656
     sha1: d168d39632798f8be799d21bd0a0c9ca13533272
     description: "Flag icon, game list region unclassified"
-    source_ref: "pcsx2/ImGui/FullscreenUI.cpp:2846, pcsx2/GameList.cpp:155-190, pcsx2-qt/GameList/GameListModel.cpp:486"
+    note: "Opened as icons/flags/Other.svg by the fullscreen game list (pcsx2/ImGui/FullscreenUI.cpp:2846)."
+    source_ref: "pcsx2/GameList.cpp:155-190, pcsx2-qt/GameList/GameListModel.cpp:486"
 
   - name: pl.svg
     path: pcsx2/resources/icons/flags/pl.svg