[Xcb] XCB documentation effort status update
michael+xcb at stapelberg.de
Sun Nov 27 02:44:12 PST 2011
Sending another status mail because the one from yesterday seems stuck in the
moderation queue or something :).
Status update: I "completed" documentation on 32 functions. With complete I
mean that there is some kind of explanation for all parameters, a description,
a list of possible errors and a 'see also' section. In some places, there are
still TODO entries for missing high-level or detail explanations. Help is
I created the following three repositories on github:
Pregenerated manpages for easier reviewing.
My changes to libxcb.
My changes to xcb-proto.
Feel free to send pull requests/patches on any of them. I will keep them up to
There are 17 requests left until I documented all requests which i3 uses. This
is the first milestone in this project and it should be reached by the end of
Further steps after reaching this milestone are:
1) Document the events.
2) Cleanup the manpage generator code.
3) Look into extending the Doxygen generation code to include the now-existing
4) Get the patch in a clean shape and get it submitted.
If anyone wants to help me in any way, please feel free to contact me.
Proofreading, comments, suggestions, etc. are very welcome.
More information about the Xcb