Unsurprisingly for this level of library code, it's not 100% super-obvious or easy to understand.

Sounds like you visit the wrong libraries. Try plan9's