Bug 29392

Summary: Tutorial uses wrong function, confusion ensues
Product: XCB Reporter: Devin J. Pohly <djpohly+freedesktop>
Component: MiscAssignee: xcb mailing list dummy <xcb>
Status: RESOLVED FIXED QA Contact: xcb mailing list dummy <xcb>
Severity: normal    
Priority: medium    
Version: unspecified   
Hardware: Other   
OS: All   
Whiteboard:
i915 platform: i915 features:

Description Devin J. Pohly 2010-08-03 17:10:29 UTC
The XCB tutorial ("Events" page) both on the website and in Git currently states:

If [a] window has already been created, we can use the xcb_configure_window() function to set the events that the window will receive.

It then goes on to show an example of how one would use this function for this task.

But if my understanding of Xlib and reading of xproto.c steer me correctly, xcb_configure_window() will resize and move a window about, but xcb_change_window_attributes() is the function which allows setting of event masks, background pixmaps, colormaps, and so forth.  It has the exact same signature, but it's a very different function!

It would be nice if this could be changed, especially since the tutorials are still the best/only XCB docs out there.
Comment 1 Eamon Walsh 2010-08-04 21:52:32 UTC
Fixed.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.