Browse Source

G-155 increment A followup: 'built modules' -> 'minted modules' in end-of-run guidance + diagram/helptext residue

Assisted-by: harness=claude; primary-model=claude-fable-5; api-location=anthropic.com
master
Julian Noble 1 week ago
parent
commit
66dc6133ba
  1. 16
      src/make.tcl

16
src/make.tcl

@ -2800,7 +2800,7 @@ DIAGRAM 2 - KIT ASSEMBLY DETAIL (the 'make.tcl bake' stage; incl. vfslibs phase)
ones; unknown names error before any bake)
bin/runtime/<target>/<runtime> bare Tcl runtime (tclkit / tclsfe / suite build), in the
store tier of the TARGET platform it bakes kits for [K9]
src/vfs/_vfscommon.vfs/ common payload (built modules + libs, main boot support)
src/vfs/_vfscommon.vfs/ common payload (minted modules + libs, main boot support)
src/vfs/<kitspecific>.vfs/ per-kit overlay (main.tcl, kit-only modules/config)
src/vfs/<kitspecific>.vfs.toml optional per-.vfs payload declaration (G-115): [payload.*]
entries materialized INTO the .vfs folder by the vfslibs
@ -3167,7 +3167,7 @@ if {[info exists ::env(PUNKBOOT_PLAIN)] && [string is true -strict $::env(PUNKBO
G-115) so a bake cannot ship stale binary libs; a selective
bake narrows that phase to the named kits' vfs folders.
Does not rebuild modules/libs and does not run the promotion gates -
built modules reach the kit payload only via 'make.tcl
minted modules reach the kit payload only via 'make.tcl
vfscommonupdate' (committed for provenance). Consumer full path from
a clean checkout: 'make.tcl bakehouse'."
bakelist
@ -7114,11 +7114,11 @@ set installername "make.tcl"
if {$::punkboot::command ni {bakehouse bake bin}} {
#command = packages/modules/libs/vfslibs - stops before kit assembly
puts stdout "vfs folders not checked"
puts stdout " - use 'make.tcl vfscommonupdate' to promote built modules into the base vfs folder (promotion gate - commit for provenance)"
puts stdout " - use 'make.tcl vfscommonupdate' to promote minted modules into the base vfs folder (promotion gate - commit for provenance)"
puts stdout " - use 'make.tcl bake' to bake executable kits/zipkits from the vfs folders if you have runtimes installed"
puts stdout " Note that without the vfscommonupdate step, 'make.tcl bake' will include any manual changes in the *custom* vfs folders but"
puts stdout " without the latest built modules."
puts stdout " calling 'builtexename(.exe) dev' will allow testing of built modules before they are baked into the kits/zipkits via 'vfscommonupdate' then 'bake'"
puts stdout " without the latest minted modules."
puts stdout " calling 'builtexename(.exe) dev' will allow testing of minted modules before they are baked into the kits/zipkits via 'vfscommonupdate' then 'bake'"
puts stdout " - consumer full path from a clean checkout: 'make.tcl bakehouse'"
puts stdout "-done-"
exit 0
@ -9437,10 +9437,10 @@ set had_kits [expr {[llength $installed_kits] || [llength $failed_kits] || [llen
if {$had_kits} {
puts stdout " module builds and kit/zipkit builds processed (kit mapping: src/runtime/mapvfs.toml)"
puts stdout " - use 'make.tcl modules' to build modules without baking the vfs folders into executable kits/zipkits"
puts stdout " - use 'make.tcl vfscommonupdate' to promote built modules into the base vfs folder <projectdir>/src/vfs/_vfscommon.vfs (promotion gate)"
puts stdout " - use 'make.tcl vfscommonupdate' to promote minted modules into the base vfs folder <projectdir>/src/vfs/_vfscommon.vfs (promotion gate)"
puts stdout " - Note that without the vfscommonupdate step, 'make.tcl bake' (the kit-assembly stage of 'make.tcl bakehouse') will build vfs based executables"
puts stdout " that include your current custom vfs folders in src/vfs, but with a _vfscommon.vfs that doesn't have the latest built modules"
puts stdout " calling 'builtexename(.exe) dev' will allow testing of built modules before they are baked into the kits/zipkits via 'vfscommonupdate' then 'bake'"
puts stdout " that include your current custom vfs folders in src/vfs, but with a _vfscommon.vfs that doesn't have the latest minted modules"
puts stdout " calling 'builtexename(.exe) dev' will allow testing of minted modules before they are baked into the kits/zipkits via 'vfscommonupdate' then 'bake'"
} else {
puts stdout " module builds processed"
puts stdout ""

Loading…
Cancel
Save