oot/include, branch main

z_scene Some comments and function names (#2808)

2026-09-02T16:59:35+00:00

* z_scene Some comments and function names

* review changes

* further fixing from comments

* vromAddr

---------

Co-authored-by: djevangelia

Document an includes style, apply to z_demo.c and z_play.c (#2803)

2026-09-01T16:58:33+00:00

* Document an includes style, apply to z_demo.c and z_play.c

* "reverse" style includes

* bss

* clarify what a "main header" is

* Update docs/includes.md

Co-authored-by: Tharo 

* Update docs/includes.md

---------

Co-authored-by: Tharo

Document pass on WaterBox code (#2695)

2026-08-31T16:46:13+00:00

* Document pass on WaterBox code

* implement suggestions, missing comment

---------

Co-authored-by: Dragorn421

[cc0 oot] z_vis* (#2782)

2026-08-31T16:36:25+00:00

* [cc0 oot] z_vis*

* bss

* docs

* fixup

* further vis docs

* add FbFilterType enum

* bss

* gfxP

gActorSetupDls (#2802)

2026-08-31T15:55:26+00:00

* gActorSetupXluDL

* gActorSetupOpaDL

* ACTOR_SETUP_OPA_DL

* BSS

* Some more usages of ACTOR_SETUP_OPA_DL

* docs

---------

Co-authored-by: Dragorn421

[cc0 oot] bowling things (#2793)

2026-08-31T15:46:12+00:00

* [cc0 oot] bowling things

* bowling fixups

* bowling things cleanup

[cc0 oot] BgDyYoseizo (#2796)

2026-08-31T15:21:31+00:00

* [cc0 oot] BgDyYoseizo

* BgDyYoseizo small cleanup

* bgdyyoseizo comment on D_80875440

Useful Eventchkinf flag renames (#2807)

2026-08-30T08:22:27+00:00

* Rename EVENTCHKINF 40, 45, 80, C7

* Rename EVENTCHKINF 40, 45, 80, C7 w format

* updated save.h comment for accuracy

Co-authored-by: Dragorn421 

* Applied 'Zelda' to 'Zeldas' & 'Pulled' to 'Obtained' adjustments

* EVENTCHKINF_INDEX_OBTAINED_ZELDA_LETTER -> EVENTCHKINF_INDEX_OBTAINED_ZELDAS_LETTER

---------

Co-authored-by: Dragorn421

Document z_eff_ss_stone1.[ch] (#2670)

2026-08-19T12:04:49+00:00

* Document z_eff_ss_stone1.[ch]

* Incorporate feedback from PR review.

From https://github.com/zeldaret/oot/pull/2670:
- Shortened excessively verbose
  suppressRTransFadeFlashAlphaStepAfterTwoFrames name to
  suppressFadeFlash
- Fixed up comment that went waaaaaay beyond the column limit in
  z_eff_ss_stone1.h
- Shortened comparison with 0 of variable bool semantics in
  z_eff_ss_stone1.c

Signed-off-by: Gabriel Ravier 

* Fix misnaming from PR review and document some more

From https://github.com/zeldaret/oot/pull/2670:
- shortenFadeFlash is incorrect - renamed to freezeFadeFlash
- Used `false` instead of 0 in EnArrow_Fly
- Elaborated comments about what exactly freezeFadeFlash does

Also added a few extra comments to z_eff_ss_stone1.c

* Ran clang-format

* More feedback from PR review, clarified comment

From https://github.com/zeldaret/oot/pull/2670:
- Change 0 to false in header comment
- Remove verbose speculation about former use of unused variable
- Made comment on use of viewDepth clearer
- Separated matrix and gfx code with a newline

Signed-off-by: Gabriel Ravier 

* Marked the "1500" as being in units

---------

Signed-off-by: Gabriel Ravier

Document `EnIn` (AKA the hard-working Ingo) (#2778)

2026-08-19T12:03:48+00:00

* Document `EnIn` (AKA the hard-working Ingo)

* Fix variable references

* Revert switch

* Rename race outcome functions for clarity

* Apply suggestions