XCB_CHANGE_ACTIVE_POINTER_GRAB(3)

💅 xcb_change_active_pointer_grab — a manual page, bestie edition

okay so this is a page from the libxcb manual (that's the XCB Requests corner of the X11 universe, xcb_change_active_pointer_grab(3), section 3, iykyk) and honestly? it's giving "the docs simply did not show up." but we're still gonna read it together, because that's what besties do. 🫶

---

✨ NAME ✨

xcb_change_active_pointer_grab —

that's it. that's the name. the description is, and I quote, nothing. the blank space is canon. 💀

---

🌸 SYNOPSIS 🌸

#include <xcb/xproto.h>

Request function (yes, it's one of those)

xcb_void_cookie_t xcb_change_active_pointer_grab(xcb_connection_t *conn,
       xcb_cursor_t cursor, xcb_timestamp_t time, uint16_t event_mask);

---

🎀 REQUEST ARGUMENTS 🎀

here come the four little parameters, and bestie, brace yourself, because the documentation for every single one of them is literally the same sentence:

• conn — The XCB connection to X11. (this one actually got documented, slay, one out of four 💖)
• cursor — TODO: NOT YET DOCUMENTED.
• time — TODO: NOT YET DOCUMENTED.
• event_mask — TODO: NOT YET DOCUMENTED.

not me reading "TODO: NOT YET DOCUMENTED" three times in a row like it was gonna change 😭 it did not. the mystery stays mysterious.

---

🦋 DESCRIPTION 🦋

there is no description. the section exists. the words do not. it's giving "I have a personality, I promise." 🙈

---

⭐ RETURN VALUE ⭐

so it returns an xcb_void_cookie_t. ✨ and here's the tea: errors (if any — if any, bestie) have to be handled in the event loop, not right here on the spot.

if you'd rather deal with errors directly using xcb_request_check instead, then you want the other girl: xcb_change_active_pointer_grab_checked. she's the checked version, she's right there. 👑

and for the full breakdown of how that all works, go read xcb-requests(3). no cap.

---

💀 ERRORS 💀

okay this part is actually iconic:

This request does never generate any errors.

never. zero. none. no errors, no drama, no crying in the terminal. periodt. 💅

---

👑 SEE ALSO 👑

nothing here either. empty. a whole section with nothing in it. the audacity is honestly main character energy. 🌈

---

🍓 AUTHOR 🍓

this page was Generated from xproto.xml. if you spot something wrong or want to make it better, hit up xcb@lists.freedesktop.org for corrections and improvements. 💌

---

and that's the whole vibe check, bestie. this page came to you from X Version 11, running libxcb 1.17.0 — take care of her, she's doing her best. 🧚💜