NAME
03-shell-bootstrap.pl - install shell bootstrap for Developer Dashboard
DESCRIPTION
This update script writes the generated bash bootstrap and appends its loader line into the user's shell rc file when needed.
PURPOSE
This staged update script owns one explicit phase of runtime update, bootstrap, and staged maintenance behavior. Read it when you need the real runtime side effects, logging, and failure behavior for that phase rather than inferring it from the higher-level command wrapper.
WHY IT EXISTS
It exists so the update pipeline stays explicit, inspectable, and testable one phase at a time. That keeps failures visible and avoids hiding important runtime changes inside one oversized installer step.
WHEN TO USE
Use this file when changing runtime update, bootstrap, and staged maintenance behavior, when debugging the staged update pipeline, or when the higher-level dashboard update flow fails and you need to isolate this phase.
HOW TO USE
Run it through dashboard update for the supported path, or invoke the file directly from the source tree when you need to debug only this phase. Keep the phase explicit, idempotent where intended, and noisy on failure.
WHAT USES IT
The staged runtime update pipeline, update-manager verification, and contributors debugging install or bootstrap regressions use this file.
EXAMPLES
Example 1:
prove -lv t/30-dashboard-loader.tRecheck the thin dashboard loader contract after changing shell bootstrap behavior.
Example 2:
prove -lv t/05-cli-smoke.tRerun the shell-helper smoke tests after changing how this phase wires the shell bootstrap.
Example 3:
dashboard updateRun the supported end-user path that can reach this update phase.
Example 4:
perl updates/03-shell-bootstrap.plInvoke only this phase while debugging the update pipeline in a source checkout.