Re: [EXTERNAL] - Attempt at writing a tutorial

Uli Schlachter <[email protected]> Thu, 11 Feb 2021 18:37:38 +0100
Newsgroups gmane.comp.freedesktop.xcb
Message-ID <[email protected]>
Hi,

checked vs unchecked requests are explained here (under the heading of
the same name):

https://www.systutorials.com/docs/linux/man/3-xcb-requests/

The short version is: This only makes a difference for X11 error
handling. With unchecked requests, any errors show up as events in e.g.
xcb_wait_for_event(). With checked requests, errors are provided when
getting the reply (or calling xcb_check_request()).

Cheers,
Uli

Am 11.02.21 um 18:28 schrieb Lucas Augusto Valentim Dantas:
> I found those values by looking into the source code, probably libxcb's, since they are passed to the second argument of the function xcb_send_request(), as can be seen here (although the "sequence" argument is gone already): https://xcb.freedesktop.org/ProtocolExtensionApi/#index3h2 but that page doesn't explain what they do.
> My goal with this tutorial is to provide enough for the reader to understand the X documentation so he is able to "navigate" on his own, that is what I am trying to do myself.
> ________________________________
> De: Peter Harris <pharris-gGaKbNYk6w1Wk0Htik3J/[email protected]>
> Enviado: quinta-feira, 11 de fevereiro de 2021 14:15
> Para: Lucas <[email protected]>; [email protected] <[email protected]>
> Assunto: RE: [EXTERNAL] - [Xcb] Attempt at writing a tutorial
> 
> On 2021-02-10 Lucas wrote:
>> I am writing a XCB tutorial as an exercise, so far, this is what I
>> have https://biteiro.ga/xcb.html
>>
>> There are a few things I couldn't find details yet, such as what does
>> the flags XCB_REQUEST_CHECKED, XCB_REQUEST_RAW,
>> XCB_REQUEST_DISCARD_REPLY, and XCB_REQUEST_REPLY_FDS do?
> 
> Those values are for internal use by libxcb (and/or xlib), and are not intended to be used by a normal user of libxcb.
> 
> Who is your tutorial intended for? Showing the inner workings is more of a "deep documentation" thing than a "tutorial" thing.
> 
>> Are there any
>> explanations on the members of the struct xcb_unmap_window_request_t?
> 
> libxcb is a thin wrapper around the X11 protocol. As such, the documentation for those fields can be found at:
> 
> https://www.x.org/releases/X11R7.7/doc/xproto/x11protocol.html#request_format
> 
> https://www.x.org/releases/X11R7.7/doc/xproto/x11protocol.html#requests:UnmapWindow
> 
> Peter Harris
> 
> 
> _______________________________________________
> Xcb mailing list
> [email protected]
> https://lists.freedesktop.org/mailman/listinfo/xcb
> 


-- 
<alanc> I think someone had a Xprint version of glxgears at one point,
    but benchmarking how many GL pages you can print per second
    was deemed too silly to merge