Skip to content

docs(cli): document -C output set and distinguish it from moria's -C - #38

Merged
nmatt0 merged 1 commit into
feat/cli-flag-coherencefrom
docs/outdir-sbom
Oct 22, 2026
Merged

nmatt0 merged 1 commit into
feat/cli-flag-coherencefrom
docs/outdir-sbom

Conversation

@nmatt0

@nmatt0 nmatt0 commented Oct 22, 2026

Copy link
Copy Markdown
Owner

What

Docs-only cleanup of -C/--outdir.

  • The man -C entry only mentioned mithril-report.json, but -C also writes
    sbom.cdx.json and sbom.spdx.json when the SBOM pass runs. Those
    standard-format SBOMs are reachable only through -C (the JSON report
    carries components inline, but not the CycloneDX/SPDX documents). The man page
    now says so.
  • Note in the man page that moria(1) also has a -C, but it means that tool's
    extraction output directory, whereas mithril's is the report output directory,
    so a moria user is not surprised.
  • README's SBOM pass description now states that the CycloneDX/SPDX files come
    from -C.

No behavior change. Builds on the flag-coherence PR; its base retargets on
merge.

The -C/--outdir man entry only mentioned mithril-report.json, but -C also
writes sbom.cdx.json and sbom.spdx.json when the SBOM pass runs, and those
standard-format SBOMs are reachable only through -C (the JSON report carries
components inline, but not the CycloneDX/SPDX documents). Spell that out in
the man page and README, and note that moria(1) also has a -C that means
something different (its extraction output directory) so a moria user is not
surprised.

Docs only; no behavior change.
@nmatt0
nmatt0 merged commit 02adb9a into feat/cli-flag-coherence Oct 22, 2026
4 checks passed
@nmatt0 nmatt0 mentioned this pull request Oct 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant