[Xcb] XCB documentation effort status update
alan.coopersmith at oracle.com
Tue Nov 29 19:43:55 PST 2011
On 11/29/11 12:20, Michael Stapelberg wrote:
>> - xcb_grab_button - For your question about "in the future", that's not a
>> reference to a planned change, but a reference to what happens in the
>> program after this call is made.
> I see. I just removed the "In the future", since everything is going to happen
> in the future (after the request was sent). Or is there some important nuance
> I’m missing here?
It's that it doesn't do the active grab right away, but waits until the listed
conditions are true, and does the grab then.
>> - xcb_set_input_focus - the revert_to argument gives a list of values named
>> XCB_INPUT_FOCUS_*, then a bunch of text describing them with
>> XCB_REVERT_TO_* names instead.
> Left-over of an old run, updated, see below.
Right, it wasn't until after I sent that message that I tried a build of the
repos I cloned from yours and saw that some of the things I mentioned in the
pregenerated pages were already fixed in the sources.
>> - Would you use XML entities or some other method to define repeated
>> information? For instance, xcb_list_fonts, xcb_list_fonts_with_info,
>> xcb_open_font, etc. could all use a consistent explanation/pointer to
>> the XLFD doc for font pattern / name conventions. And that doc may
>> be found locally (for instance, I package it for Solaris 11 in
>> /usr/share/doc/X11/specs/XLFD/ ) or it can be found online at
> Hm, I guess the online reference is more useful (since system-independent). I
> would add that as another<see> tag for the SEE ALSO section. Do you agree or
> did you have something very different in mind?
That seems reasonable.
-Alan Coopersmith- alan.coopersmith at oracle.com
Oracle Solaris Platform Engineering: X Window System
More information about the Xcb