xpaxt(7)

📦 version 2.1.20, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ xpaxt ✨ — the XPA Interface to Xt (X Windows) 💖

okay bestie, so this is the xpaxt(7) page from the SAORD Documentation set, and it's literally the glow-up guide for making XPA and X Toolkit ✨coexist✨. no cap.

🌸 SYNOPSIS 🌸

it describes how XPA access points can be added to X Toolkit (Xt) programs. that's it. that's the vibe. 🦋

🎀 DESCRIPTION 🎀

so here's the tea, bestie: XPA supports Xt programs. you can call XPANew(), XPACmdNew(), or XPAInfoNew() inside any C routine and boom 💥 — you've added XPA server callbacks to an Xt program. iconic behavior honestly.

the thing is, an Xt program already has its own event loop call, aka XtAppMainLoop(). so it does not need or want to use the XPA event loop. it's giving "i already have a main character, thanks." 💅

so, to add XPA access points to the standard Xt event loop, you call this routine before entering the loop:

int XPAXtAddInput(XtAppContext app, XPA xpa)

and what does it do? the XPAAddAddInput() routine adds XPA access points to the Xt event loop by making calls to the standard XtAppAddInput() routine. slay.

some little deets you do NOT wanna skip:

  • if the XtAppContext argument is NULL, then the alternate XtAddInput() routine is used instead. plot twist 🌈
  • if the xpa argument is NULL, then all active XPA access points get added to the loop. everything. the whole squad. 👑
  • if xpa is not NULL, then only the specified access point is added. just the one, your fave. 💖

that last type of call is the one you use to add new access points from within a callback, after the program has already entered the XtAppMainLoop() even loop. yes, you can add more friends to the party after it's started. obsessed. 🫶

🦋 SEE ALSO 🦋

  • See xpa(n) for a list of XPA help pages ✨

and that's the whole page, bestie!! 💖 stay hydrated, read your man pages, and remember: the Xt event loop is doing its best and so are you 🧚

signing off with much love from the SAORD Documentation crew — this was version 2.1.15, dated July 23, 2013 🌸 (yes the vintage is part of the charm, it ate fr fr) 💅

📦 where this page comes from