Skip to content

Docs and dead-code cleanup for tracegen optimizations#790

Merged
MauroToscano merged 1 commit into
perf/tracegen-cpu-optimizationsfrom
review/pr786-docs-deadcode
Jul 7, 2026
Merged

Docs and dead-code cleanup for tracegen optimizations#790
MauroToscano merged 1 commit into
perf/tracegen-cpu-optimizationsfrom
review/pr786-docs-deadcode

Conversation

@MauroToscano

Copy link
Copy Markdown
Contributor

Follow-up to the #786 review — the quick documentation/dead-code batch (no behavior changes):

  • Reattach the collect_ops_from_cpu doc block to the function. It was syntactically attaching to struct RegRow (together with a stray #[allow(clippy::type_complexity)]), leaving the collector undocumented and RegRow documented as an 11-tuple-returning function. The Returns list now names the MemwBuckets shape.
  • Remove references to code and review artifacts that no longer exist: memw_register_is_half_lookup's "Shared by BOTH collectors" rationale (this PR deleted the MemwOperation collector), the E6/E7 notes, and the collect_bitwise_from_memw_register mention. The comment now states the invariant that actually matters: the counted lookup must stay in lockstep with the IS_HALFWORD send in memw_register::bus_interactions().
  • Correct mu_column's "legacy per-op path" label — update_multiplicities is live production code (continuation epochs add L2G lookups through it).
  • Document fill_multiplicities' overwrite semantics: it assumes zeroed MU columns (true for a fresh generate_bitwise_trace), and layered lookups must be added strictly after the fill.
  • Remove BitwiseHistogram::total — pub method with zero callers, invisible to the dead-code lint.

cargo check -p lambda-vm-prover and cargo fmt --check pass.

- Reattach the collect_ops_from_cpu doc block to the function (it was landing
  on struct RegRow together with a stray #[allow]) and update its Returns list
  to the MemwBuckets shape
- Replace references to deleted code and internal review artifacts: the
  'Shared by BOTH collectors' rationale (the MemwOperation collector is gone),
  the E6/E7 notes, and mu_column's 'legacy path' label (update_multiplicities
  is live for continuation epochs)
- Document fill_multiplicities' overwrite semantics: it assumes zeroed MU
  columns and layered lookups (continuation L2G) must be added strictly after
- Remove BitwiseHistogram::total, a pub method with no callers
@MauroToscano MauroToscano force-pushed the review/pr786-docs-deadcode branch from a0ba503 to ae7d5d4 Compare July 7, 2026 14:44
@MauroToscano MauroToscano merged commit 402952c into perf/tracegen-cpu-optimizations Jul 7, 2026
14 checks passed
@MauroToscano MauroToscano deleted the review/pr786-docs-deadcode branch July 7, 2026 15:21
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