Browse pages
Generate Provisions
litespec provisions writes the provision index that resolves every identifier to its page.
Name#
litespec provisions writes the provision index that resolves every identifier to its page.
Synopsis#
litespec provisions [--root <path>] [--check] [--help]Description#
This command rebuilds docs/reference/provisions.md from the active standards, so a citation reaches its heading in one step. The page carries each provision with its verification mark and its evidence.
Run it after adding, renaming, or removing a provision. The next run overwrites a hand edit.
Arguments#
None. Everything passes through options.
Options#
| Option | Default | Effect |
|---|---|---|
--root <path> | the LiteSpec checkout the tool ships in | Selects the LiteSpec repository to read. |
--check | off | Compares the page with the active standards and writes nothing. |
--help | off | Prints the synopsis, the options, and the exit codes, then exits zero. |
Exit codes#
| Code | Meaning |
|---|---|
0 | The page was written, or --check found it current. |
1 | --check found the page stale. |
2 | The usage is invalid. |
Examples#
Rebuild the page after a provision change:
litespec provisionsCompare without writing, which is what continuous integration runs:
litespec provisions --checkUnderneath#
litespec validate reads the same builder and reports a stale page as PROVISIONS_STALE. Nothing beneath this command is separately runnable.