xcb_set_font_path(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_set_font_path β€” from the XCB Requests fam, page xcb_set_font_path(3) πŸ’«

okay bestie sit down, we're doing an XCB request page together and it's gonna be a whole vibe πŸ¦‹


✨ NAME ✨

xcb_set_font_path β€” and that's literally it, the description line is empty, no cap πŸ™ˆ


✨ SYNOPSIS ✨

First things first, you gotta pull in the header:

#include <xcb/xproto.h>

πŸŽ€ Request function

xcb_void_cookie_t xcb_set_font_path(xcb_connection_t *conn,
       uint16_t font_qty, const xcb_str_t *font);

that's the whole signature, copy it exactly bestie, don't freestyle πŸ’…


✨ REQUEST ARGUMENTS ✨

  • conn β€” the XCB connection to X11. it's giving "the link to your X server," iconic 🫢
  • font_qty β€” TODO: NOT YET DOCUMENTED. yeah girl, the docs said "we'll get to it" and then never did 😭
  • font β€” TODO: NOT YET DOCUMENTED. same energy, same void, fr fr πŸ’€

✨ DESCRIPTION ✨

so… there is no description. the section exists and it's just empty. nothing here. not a single line. it's giving minimalist main character energy and honestly? respect 🌸


✨ RETURN VALUE ✨

this one hands you back an xcb_void_cookie_t. and because it's a void cookie, any errors (if any even show up) have to be handled over in the event loop, not right here in your face. that's just how it works ✨

if you'd rather handle errors directly with xcb_request_check instead, then you want the xcb_set_font_path_checked version of this function. go read xcb-requests(3) for the whole rundown, it explains the details πŸ’œ


✨ ERRORS ✨

good news for once: this request does never generate any errors. zero. none. not a single one. slay πŸ’…

✨ SEE ALSO ✨

nothing listed here β€” the section is empty, so there are no references to hand you. no crumbs. πŸ¦‹


✨ AUTHOR ✨

generated from xproto.xml. if you spot something wrong or wanna send improvements, hit up xcb@lists.freedesktop.org β€” they're the ones who take corrections and improvements, so send your notes their way πŸ“¬


and that's the page bestie, you ate it, periodt πŸ‘‘

πŸ’– sign-off corner πŸ’– β€” this one's living under X Version 11, shipped with libxcb 1.17.0, and the page footer is stamped xcb_set_font_path(3). go forth and set those font paths, gorgeous 🌈✨