phux
reference

phux reference

Generated reference documentation, rendered from the compiled binary and byte-pinned by a freshness test so it cannot drift from the code.

evolving document
Full source summary

Generated reference documentation, rendered from the compiled binary and byte-pinned by a freshness test so it cannot drift from the code. The table below routes to each page; none of these files is edited by hand.

Generated from the binary

Exact commands, defaults, actions, widgets, hooks, exit codes, and paths. These pages fail CI if they drift from phux.

CLIEvery invocation path, flag, default, and help string.ConfigurationAccepted sections, values, defaults, and examples.Runtime contractsExit codes, files, hooks, actions, and deprecations.

Every file in this directory is rendered from the compiled phux binary by just docs-gen; none of it is written by hand. A unit test re-renders each page and byte-compares it against this tree, so the reference cannot drift from the binary without failing the test suite.

PageContents
cli.mdEvery non-hidden phux invocation path with its flags, defaults, and help text.
config.mdEvery config.toml section, the scalar defaults, and the annotated default config.
actions.mdEvery dispatcher action with its parameters, description, and palette placement.
widgets.mdEvery registered status-bar widget kind with its options and defaults.
hooks.mdEvery hook event the server fires, with its context keys, environment projection, and matching rules.
exit-codes.mdEvery exit code the binary uses and what each one means.
files.mdThe symbolic path rule for every file phux reads or writes: socket, config, logs, TLS material, tokens.
deprecations.mdEvery deprecated spelling, its replacement, and its removal release.
View exact source