[Xcb] [Bug 29392] New: Tutorial uses wrong function, confusion ensues

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=29392

           Summary: Tutorial uses wrong function, confusion ensues
           Product: XCB
           Version: unspecified
          Platform: Other
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: medium
         Component: Misc
        AssignedTo: xcb at lists.freedesktop.org
        ReportedBy: djpohly+freedesktop at gmail.com
         QAContact: xcb at lists.freedesktop.org


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.

-- 
Configure bugmail: https://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.