xcb_render_free_glyphs(3)

📦
version 1.17.0 · 4 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 xcb_render_free_glyphs — the XCB request page, bestie edition 💖

okay so. this is a page from the XCB Requests section of the manual, and it's all about xcb_render_free_glyphs. the NAME line in the original is literally just the function name with nothing after it, so like… no vibe description, no tea, just the name. iconic behaviour honestly. ✨

✨ SYNOPSIS ✨

first things first, you gotta pull in the header:

#include <xcb/render.h>

🎀 Request function

xcb_void_cookie_t xcb_render_free_glyphs(xcb_connection_t *conn,
       xcb_render_glyphset_t glyphset, uint32_t glyphs_len, const
       xcb_render_glyph_t *glyphs);

that's the whole signature, copy it exactly, don't freestyle it 💅

🦋 REQUEST ARGUMENTS 🦋

  • conn — the XCB connection to X11. she's the link to the server, the main character of every request ngl.
  • glyphset — TODO: NOT YET DOCUMENTED. yeah bestie, the docs said "not yet" and left it at that 😭
  • glyphs_len — TODO: NOT YET DOCUMENTED. same energy fr fr
  • glyphs — TODO: NOT YET DOCUMENTED. the trifecta of mystery 🙈
not me having to relay TODO: NOT YET DOCUMENTED. four times. the upstream docs really said "figure it out" and dipped. i'm not gonna invent lore for them either, because that would be lying and we don't do that here 🫶

🌸 DESCRIPTION 🌸

the DESCRIPTION section on this page is, and i cannot stress this enough, completely empty. nothing. a whole vibe vacuum. so there is genuinely nothing to explain beyond what's already up there. periodt.

🌈 RETURN VALUE 🌈

she returns an xcb_void_cookie_t. that's it, that's the return.

any errors (if there even are any) have to be handled in the event loop. that's the deal with void cookies — they're like a "your request is in the mail" receipt, not a "here's your answer" package 📬

if you'd rather handle errors directly with xcb_request_check instead of waiting around in the event loop, use xcb_render_free_glyphs_checked. same request, just a checked cookie.

more deets live in xcb-requests(3) — go read it, it's giving essential lore.

💀 ERRORS 💀

this request never generates any errors. like, ever. zero. not one. so if you were bracing for chaos… you can unclench bestie, she's a well-behaved request 💜

👑 SEE ALSO 👑

the SEE ALSO section is empty on this one. nothing linked, no cross-refs, nada. moving on 🧚

⭐ AUTHOR ⭐

generated from render.xml. if you spot something wrong and want corrections and improvements, hit up xcb@lists.freedesktop.org — they're the ones to tell 🍓

lowkey the most important takeaway: this page is short, some of it is literally TODO: NOT YET DOCUMENTED., and i'm keeping it that way instead of making stuff up. no cap. 🎀

and that's the whole page, bestie — this was xcb_render_free_glyphs from X Version 11, libxcb 1.17.0. slay, go free some glyphs 💅✨🔥

📦 where this page comes from