Documentation
¶
Overview ¶
check-generated's default mode exits non-zero when committed generator-input provenance is stale. It does not compare generated output bytes. The -needs-generation query additionally checks output readiness, while the Makefile's `check-generated` target performs full regeneration comparisons. Content-based input checks are reliable across git/jj checkouts.
With -write it instead recomputes the digest and rewrites the canonical manifest (a light refresh — the digest only, no bundle/tree rebuild). With -o PATH it writes the recomputed digest to PATH; that is how the generated.sums git merge driver (scripts/git-merge-sums.sh) produces the merged manifest at git's output path. Recomputing beats keep-current so the signature never lands stale after a merge.