From 3ccc33b3e833e936d743fc1f646f8f2c1ef3c376 Mon Sep 17 00:00:00 2001 From: chrg6 Date: Mon, 9 Nov 2026 10:27:34 -0500 Subject: [PATCH] Describe in docs/launcher.md how an update now keeps the compiled game and the prepared shaders. Co-Authored-By: Claude Opus 5.5 --- docs/launcher.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/docs/launcher.md b/docs/launcher.md index 92c705a5..9c51544e 100644 --- a/docs/launcher.md +++ b/docs/launcher.md @@ -185,11 +185,18 @@ The stub swaps `python.next` in while no Python runs, then starts the new versio header written per install (`layout.h`, `patches.h`, `romfs_config.h`) are compiled on the player's PC. - Every other file compiles only when its source, a header it includes, the flags or the compiler changed (`build-cache/obj/objects.json`, from clang's dependency files). The kit's folder is not part of that key, so the - objects of the version before are reused although each version lives in its own folder. The lifted code - includes only `cpu.h` and `simd.h`: a change there compiles it all again, which is rare. + objects of the version before are reused although each version lives in its own folder. The compiler counts by + its version and size, not its file time, and the faster CLANG64 compiler, whose objects are the same, not at all. + The lifted code includes only `cpu.h` and `simd.h`: a change there compiles it all again, which is rare. + - An object an earlier version recorded under its own key form is taken over when its compile and its files are + the same (`ObjectCache.adopt`): 0.6.0's keys, and 0.5.0's, which named the kit's folder. An update keeps the + x86-64 level the game's code was compiled for (`build-cache/obj/lifted-build.json`; generic for the objects of + 0.5.0 and earlier); Rebuild the Game compiles it for this processor's (`--retune`). 6. **Swap In the New Build**: lld links `ocarina.exe.new`, which replaces `ocarina.exe` only once it is complete. A failed rebuild leaves the old build playable; Rebuild the Game tries again. -7. **Prepare the Shaders** again for the new build; shaders the translator already prepared come from the cache. +7. **Prepare the Shaders** is skipped once shaders were prepared before (`shader-prepared.bin`): the game keeps using + them and translates them again with the new translator in the background (`NX2NAVI_SHADER_CARRY`). With + `shader_carry = 0`, or nothing prepared yet, the step prepares them all as at the install. 8. **Draw the Button Prompts**, with button art in the new version: only when the art, the prompt tools or the key bindings changed, or a prompt folder is missing (a first version with art draws them all). 9. Every version but the current and the previous one is deleted, except a staged release newer than the current