I've added some notes on how Self integrates with the X11 event loop in the wiki: https://github.com/russellallen/self/wiki/X11-Event-Loop
They come from a discussion in this github issue:
I haven't written about the dead ends I encountered while looking for it (the eventWatcher stuff mentioned at https://github.com/russellallen/self/issues/79#issuecomment-255560434) but will once I understand what that is for.
If anyone can add to the knowledge there, please do. It'd be great to collaborate on getting some system documentation in place.
Would it be worth adding this type of thing to the documentation in the Self world too (via method/object comment attributes, etc)?