]> git.hungrycats.org Git - bees/commit
docs: say what --show-builtin-config resolves
authorZygo Blaxell <bees@furryterror.org>
Mon, 31 Aug 2026 01:56:54 +0000 (21:56 -0400)
committerZygo Blaxell <bees@furryterror.org>
Sat, 5 Sep 2026 04:03:59 +0000 (00:03 -0400)
commite83cec5fdeca224cc16f354c9dc23d35feb73ff2
tree4808ecdbef73612bc7da0aaf2544d439409addb2
parent38bd247665918fa935d09a0cb94160a0e729cc86
docs: say what --show-builtin-config resolves

The description said the command writes "the built-in configuration for
VERSION", which reads as the contents of the schema file with that name.
It is not: a schema states only the keys it changes, so the command
flattens the whole inheritance chain and prints what the version resolves
to.

The distinction is the one a reader is most likely to get wrong, because
the surprising half looks like a bug -- asking for version 1 lists
options version 1 has never heard of.  Say why that is right (a daemon
pinned to that version resolves them too), and say what happens where the
versions disagree (the selected version's value wins), with the concrete
case.

Assisted-by: Claude-Code:claude-opus-5
docs/options.md