XMADDPROTOCOLS(3)

📦
version 2.5.2 · 2 versions
, in alpine 3.24, arch rolling, centos-stream 9, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

💖 NAME 💖

XmAddProtocols — a VendorShell function that adds the protocols to the protocol manager and allocates the internal tables 🫶

okay so bestie, this is one of those library call pages, the kind you find in the X/Motif corner of the man world. she's not a command, she's a function, and she's here to do exactly two things and she does them fabulously. no cap. 💅

✨ SYNOPSIS ✨

#include <Xm/Protocols.h>
void XmAddProtocols(
Widget shell,
Atom property,
Atom *protocols,
Cardinal num_protocols);

look at her. four arguments. clean. iconic. not a single default value in sight because this girl doesn't do defaults, she does exactly what you tell her. 😌

🌸 DESCRIPTION 🌸

XmAddProtocols adds the protocols to the protocol manager and allocates the internal tables. that's it. that's the whole vibe. she walks in, she registers your protocols, she allocates the internal tables, she leaves. main character energy fr fr. 💖

also, plot twist that you absolutely need to know:

XmAddWMProtocols is a convenience interface. it calls XmAddProtocols with the property value set to the atom returned by interning WM_PROTOCOLS. so like… she's the same girl, just already dressed for the WM party. 🎀

🦋 the parameters (yes queen, all four) 🦋

  • shell — specifies the widget with which the protocol property is associated 👑
  • property — specifies the protocol property ✨
  • protocols — specifies the protocol Atoms 🧚
  • num_protocols — specifies the number of elements in protocols 🌈
💀 do not fumble num_protocols, bestie. she wants the count of elements in protocols. that is a number. that is your job. that is not a vibe check, that is a fact check.

and if you want the full tea on VendorShell and all her associated resources — like, the whole lore, not just the highlights — go read VendorShell(3). she's the source of truth and she's serving. 🫶

(the one that adds, the one that adds but with WM_PROTOCOLS already interned, the one that interns your atoms, and the one that takes it all back when you're done. a whole little friend group. obsessed. 🍓)

aaaand that's the page!! 💖 this was XmAddProtocols from the library call manual section — yes, the header and footer both just say XmAddProtocols(library call) like a signature she's not changing for anybody, periodt. go forth, add your protocols, allocate those internal tables, and slay responsibly. 🎀✨🦋

📦 where this page comes from