Skip to content

docs: MachineBlockPlacement part 2 — static probabilities and PGO - #11

Merged
compilersutra merged 1 commit into
mainfrom
docs/mbp-wrong-bet-part2
Sep 1, 2026
Merged

docs: MachineBlockPlacement part 2 — static probabilities and PGO#11
compilersutra merged 1 commit into
mainfrom
docs/mbp-wrong-bet-part2

Conversation

@compilersutra

Copy link
Copy Markdown
Owner

Summary

  • Adds part 2 of the parse-loop case study: why MachineBlockPlacement picks a bad layout without profile data, and how PGO branch_weights restore O1-like misses.
  • Bundles IR/asm/perf artifacts, revalidate.sh, and run_pgo_matrix.sh under static/files/articles/machineblockplacement-wrong-bet-static-probabilities-pgo/.
  • Links from part 1, sidebar, and articles index; fixes the part 1 index table row.

Test plan

  • ./scripts/revalidate.sh from artifact bundle — correctness PASS, Clang 18 shows ~2.6× branch misses at -O2, PGO fixes layout
  • npm run build — site builds; both articles present under build/docs/articles/
  • Review rendered pages: /docs/articles/machineblockplacement-wrong-bet-static-probabilities-pgo and part 1 cross-links

Made with Cursor

Follow-up to the -O2 vs -O1 parse-loop case study: branch mix, missing
branch_weights without PGO, PGO matrix on Clang 18, artifact bundle and
revalidate script. Links part 1 and fixes the articles index row.

Co-authored-by: Cursor <cursoragent@cursor.com>
@compilersutra
compilersutra merged commit cc15465 into main Sep 1, 2026
1 check failed
compilersutra pushed a commit that referenced this pull request Sep 3, 2026
Merge pull request #11 from compilersutra/docs/mbp-wrong-bet-part2
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