GLUTSETWINDOWSTAYONTOP(3)

okay so bestie 💖 you opened glutSetWindowStayOnTop(3) and honestly? iconic of you. it's the little OpenGLUT call that asks your window manager to pretty please keep a window on top. spoiler alert: it does not always work, and the manpage itself is lowkey going through it. let's unpack 🫶

🌸 NAME 🌸

• glutSetWindowStayOnTop — sets stay on top mode for the current window ✨

📚 LIBRARY 📚

OpenGLUT — experimental. (yes, "experimental" is doing a LOT of heavy lifting in that sentence, we respect the honesty tho)

🧚 SYNOPSIS 🧚

#include <openglut.h>

void
glutSetWindowStayOnTop(int enable);

🎀 PARAMETERS 🎀

• enable — literally just either GL_TRUE or GL_FALSE. that's the whole vibe check, no in-between.

💅 DESCRIPTION 💅

okay so this is the part where i'm supposed to explain what the function does, and the original page is completely empty. like. nothing there. blank. it's giving "turned the assignment in with no content" 😭

so we're skipping straight to the messy parts. buckle up, bestie.

⚠️ CAVEATS ⚠️

this one does NOT work on all window managers. fr fr. no cap.

• it sends the Icewm style message to every single window manager you have running — KDE, twm, blackbox, ratpoison, amiwm, and whatever others you have. the whole group chat. all of them.
• the open question the page raises: can we reliably detect Icewm and only send the Icewm formatted message for Icewm? as it stands it's possibly harmless, but it looks wrong. 😬

📝 TODO 📝

1. Can a glutGet() be defined to tell us whether a window can be made to stay on top? Or whether a window has (successfully) been marked for staying on top?
2. Should walk the tree of menus and glutPopWindow() (or all windows that are of menu-window type?).
3. Investigate making a workalike variant using glutPopWindow() to mimic the feature where not directly supported.

and that's the whole page, bestie 🦋 it's UNDATED and the source/version tag on the bottom is UNTITLED() — so yes, this manpage is literally unnamed and undated, which is main character energy of it honestly. go forth and stay on top (when your window manager lets you) 👑💜