Expand on API docs
Submitted by Havoc Pennington
Assigned to xcb mailing list dummy
Created attachment 37965 more docs!
This patch adds quite a bit more detail to the API documentation.
It assumes the small docs patch in bug 29599 has been applied.
There are probably some mistakes in here, but hopefully someone more "in the know" can fix those.
I think it's useful to give a lot more detail about what blocks and what doesn't, how buffering and flushing works, and even spell out some basic info about the X protocol. So I tried to put that kind of thing in here.
I copied a few lines of xcbext.h docs from the wiki, but mostly had to write new docs for it.
These docs could probably still use more info about how to use XCB with threads, but I haven't sat down and tried to work that out, so I didn't document it.
Patch 37965, "more docs!":