the c++ api
one page per header, contract only
one page per header, named after it. scene/tween.h is tween, so a lookup is mechanical and nobody has
to guess which page a call is on
what a page tells you
| the signatures | read off the header, never written from memory |
| what it does when it does NOTHING | a return of 0, a null, a no-op on a stale id |
| what is BORROWED | this lib hands out raw pointers it does not own, and that is where the real traps are |
| what it will not do | saves the next person looking for it |
this is the WHAT. the WHY lives in the systems section, and a page here links to it rather than repeating any of it