Clarify diff report controls and README links

Document the text limit, JSON omission counters, and hierarchy options. Use absolute links for the documentation referenced by the README.
This commit is contained in:
Jan Petykiewicz 2026-11-18 12:37:10 -08:00
commit 9d5fe27516

View file

@ -99,18 +99,21 @@ pheon diff before.gds after.gds --hierarchy mermaid --depth 4
`--show-cell` and `--show-layer` filter displayed changes without changing the
comparison, totals, or exit status. A layer display filter hides references
without a numeric layer. `--max-changes N` limits displayed object occurrences.
Text shows a replacement only when both objects fit within the limit.
A single omission line lists changes hidden by filters or the limit. JSON
includes all changed objects unless the limit is explicit.
without a numeric layer. `--max-changes N` limits displayed object occurrences
after filtering. Text defaults to 100 occurrences and shows a replacement only
when both objects fit within the limit. A single omission line lists changes
hidden by filters or the limit. JSON has no default object limit and reports
omissions from both display filters and any explicit limit in `report_selection`.
See the [JSON reference](diff-reports.md) for the selection counters.
The diff hierarchy shows directly changed cells, affected ancestors, and targets
of modified references. It includes references from both revisions so removed
branches remain visible. Counts represent direct placements;
arrays remain symbolic. ASCII omits the section when there are no cell changes
and marks reference changes whose placement count stays the same.
`--depth` limits text diagrams. For a complete graph in
JSON, use `--format json --hierarchy graph`; text depth and display filters do
not trim that graph.
branches remain visible. Counts represent direct placements, with symbolic
counts for arrays. ASCII omits the section when there are no cell changes and
marks reference changes whose placement count stays the same. Use `--depth`
with text output.
For the complete graph within the comparison scope, use
`--format json --hierarchy graph` without `--depth`. Display filters leave the
graph intact.
Next: configure [Git integration](git.md) or add [layer names](layer-names.md).