ps2/docs
Watch
2
0
Fork
You've already forked docs
 0
Code Issues Pull requests 1 Projects Releases Packages 1 Wiki Activity Actions

Restructure the EE optimization guide; add a System quirks page #10

Open
techwritescode wants to merge 1 commit from docs-quirks-optimization into master
pull from: docs-quirks-optimization
merge into: ps2:master
Conversation 0 Commits 1 Files changed 4 +252 -106
techwritescode commented 2026-10-16 19:12:39 +00:00
Owner
Copy link

Making EE code faster (guide/optimization.md)

  • Three parts: compiler settings (optimization level, unused code, LTO, PGO), measuring speed, and changing the code.
  • Benchmark figures and test details are gone. The code techniques (cache-set padding, loop order, buffer alignment, keeping fixed-count loops rolled) now show before and after code.
  • Both toolchains are covered evenly, for example the unroll pragma for both LLVM and GCC.

System quirks (new, guide/architecture/quirks.md, listed in the English architecture sidebar)

  • Floating point on the EE and the R5900 short-loop erratum, moved from the optimization guide.
  • Loading IOP modules from memory needs sbv_patch_enable_lmb().
  • Buffers shared with DMA or the IOP need 64-byte alignment.

guide/iop-drivers.md links to the new page. English only, both pages marked beta. vitepress build passes.

🤖 Generated with Claude Code

**Making EE code faster** (`guide/optimization.md`) - Three parts: compiler settings (optimization level, unused code, LTO, PGO), measuring speed, and changing the code. - Benchmark figures and test details are gone. The code techniques (cache-set padding, loop order, buffer alignment, keeping fixed-count loops rolled) now show before and after code. - Both toolchains are covered evenly, for example the unroll pragma for both LLVM and GCC. **System quirks** (new, `guide/architecture/quirks.md`, listed in the English architecture sidebar) - Floating point on the EE and the R5900 short-loop erratum, moved from the optimization guide. - Loading IOP modules from memory needs `sbv_patch_enable_lmb()`. - Buffers shared with DMA or the IOP need 64-byte alignment. `guide/iop-drivers.md` links to the new page. English only, both pages marked beta. `vitepress build` passes. 🤖 Generated with [Claude Code](https://claude.com/claude-code) 
The optimization guide now covers compiler settings, measuring and code
changes, with before and after code instead of benchmark figures, and
treats both toolchains the same. Floating point on the EE, the short-loop
erratum, loading modules from memory and buffer alignment move to a new
System quirks page in the architecture section. English only.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin docs-quirks-optimization:docs-quirks-optimization
git switch docs-quirks-optimization

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch master
git merge --no-ff docs-quirks-optimization
git switch docs-quirks-optimization
git rebase master
git switch master
git merge --ff-only docs-quirks-optimization
git switch docs-quirks-optimization
git rebase master
git switch master
git merge --no-ff docs-quirks-optimization
git switch master
git merge --squash docs-quirks-optimization
git switch master
git merge --ff-only docs-quirks-optimization
git switch master
git merge docs-quirks-optimization
git push origin master
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
ps2/docs!10
No description provided.