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) ones; unknown names error before any bake)
bin/runtime/<target>/<runtime> bare Tcl runtime (tclkit / tclsfe / suite build), in the bin/runtime/<target>/<runtime> bare Tcl runtime (tclkit / tclsfe / suite build), in the
store tier of the TARGET platform it bakes kits for [K9] 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/ per-kit overlay (main.tcl, kit-only modules/config)
src/vfs/<kitspecific>.vfs.toml optional per-.vfs payload declaration (G-115): [payload.*] src/vfs/<kitspecific>.vfs.toml optional per-.vfs payload declaration (G-115): [payload.*]
entries materialized INTO the .vfs folder by the vfslibs 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 G-115) so a bake cannot ship stale binary libs; a selective
bake narrows that phase to the named kits' vfs folders. bake narrows that phase to the named kits' vfs folders.
Does not rebuild modules/libs and does not run the promotion gates - 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 vfscommonupdate' (committed for provenance). Consumer full path from
a clean checkout: 'make.tcl bakehouse'." a clean checkout: 'make.tcl bakehouse'."
bakelist bakelist
@ -7114,11 +7114,11 @@ set installername "make.tcl"
if {$::punkboot::command ni {bakehouse bake bin}} { if {$::punkboot::command ni {bakehouse bake bin}} {
#command = packages/modules/libs/vfslibs - stops before kit assembly #command = packages/modules/libs/vfslibs - stops before kit assembly
puts stdout "vfs folders not checked" 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 " - 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 " 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 " without the latest minted 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 " 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 " - consumer full path from a clean checkout: 'make.tcl bakehouse'"
puts stdout "-done-" puts stdout "-done-"
exit 0 exit 0
@ -9437,10 +9437,10 @@ set had_kits [expr {[llength $installed_kits] || [llength $failed_kits] || [llen
if {$had_kits} { if {$had_kits} {
puts stdout " module builds and kit/zipkit builds processed (kit mapping: src/runtime/mapvfs.toml)" 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 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 " - 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 " 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 built modules before they are baked into the kits/zipkits via 'vfscommonupdate' then 'bake'" 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 { } else {
puts stdout " module builds processed" puts stdout " module builds processed"
puts stdout "" puts stdout ""

Loading…
Cancel
Save