RAISE(4)

💅 Raise(special file) — raise a tool's window(s) to the front, bestie 🪟✨

✨ NAME ✨

Raise — raise a tool's window(s) to the front. That's the whole vibe: make the window(s) pop to the front. 💖

🌸 SYNOPSIS 🌸

The synopsis is literally:

Raise([in messageID commission]);

🦋 DESCRIPTION 🦋

Okay so the Raise request raises the window(s) associated with the handling procid. No cap. If any optional arguments are present, then it raises only the indicated window(s).

The commission argument is the ID of the message, if any, that resulted in the creation of the window(s) that should be raised. So yeah, it's the message-ID receipt for the window(s) getting made. 🧾✨

🎀 APPLICATION USAGE 🎀

The ttdt_session_join(3), and ttdt_message_accept(3), functions can be used by Xt applications to register for, and transparently process, the Raise request. Xt girlies, this one's for you. 💅

🔥 EXAMPLES 🔥

The Raise request can be sent as in the following example:

Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
                               the_recipient_procid, TTDT_RAISE,
                               my_callback);
tt_message_send(msg);

💀 WARNINGS 💀

Raise can also be sent as a multicast notice, as an edict to all tools in the scope of the message. The consequences of doing so can be severe and unexpected. Like, highkey do not just blast this to everyone unless you're ready for chaos. 😭🔥

🌈 SEE ALSO 🌈

• tt_message_send(3)
• ttdt_message_accept(3)
• ttdt_session_join(3)
• Lower request.

---

That's the whole page, bestie — Raise(special file) is the manual name sitting in the header and footer, and there's no source/version or date line attached here. byeee, go raise those windows 💖✨🫶