OVERRIDESHELL(3)

👑 OverrideShell(library call) 👑

okay so bestie, welcome to the manual page for OverrideShell — yes that's the library call name, that's the whole vibe, we're doing a widget class today and it's lowkey iconic. 💅

---

✨ NAME ✨

OverrideShell — the OverrideShell widget class. that's it, that's the name, she's simple and she's powerful. 🎀

---

🌸 SYNOPSIS 🌸

#include <Xm/Xm.h>
#include <X11/Shell.h>

two includes. that's all you need to pull her in. slay. ✨

---

💖 DESCRIPTION 💖

so OverrideShell is the widget class for shell windows that completely bypass the window manager. like, not "mostly", not "kinda", not "we asked nicely" — completely. she does not talk to the WM, the WM does not talk to her, they are strangers fr fr. 🫶

the classic example, the one everybody knows? PopupMenu shells. that's her moment, that's her main character energy. 🔥

🌈 Classes 🌈

OverrideShell inherits behavior and resources from Core, Composite, and Shell. the whole family tree, bestie. 🌳

• the class pointer is overrideShellWidgetClass.
• the class name is OverrideShell.

🦋 New Resources 🦋

okay so plot twist: OverrideShell defines no new resources. zero. nada. 🙈

BUT — and this is the part you need to remember — she overrides the XmNoverrideRedirect and XmNsaveUnder resources in the Shell class. so she's not adding anything new, she's just editing what her mama gave her. 💅

🍓 Inherited Resources 🍓

OverrideShell inherits behavior and resources from the following superclasses. for a complete description of each resource, go read the reference page for that superclass — I'm not gonna retype their whole life story here. 💀

so here's the tea: the following table defines a set of widget resources used by the programmer to specify data. the programmer can also set the resource values for the inherited classes to set attributes for this widget.

and now the little .Xdefaults magic trick, listen up because this is important 👇

• to reference a resource by name or by class in a .Xdefaults file: remove the XmN or XmC prefix and use the remaining letters.
• to specify one of the defined values for a resource in a .Xdefaults file: remove the Xm prefix and use the remaining letters — in either lowercase or uppercase, whichever, but include any underscores between words.

and the codes in the access column? they tell you if the given resource can be:

• set at creation time (C)
• set by using XtSetValues (S)
• retrieved by using XtGetValues (G)
• or is not applicable (N/A)

got it? got it. 💜

⭐ Shell Resource Set ⭐

• XmNallowShellResize — class XmCAllowShellResize, type Boolean, default False, access CG
• XmNcreatePopupChildProc — class XmCCreatePopupChildProc, type XtCreatePopupChildProc, default NULL, access CSG
• XmNgeometry — class XmCGeometry, type String, default NULL, access CSG
• XmNoverrideRedirect — class XmCOverrideRedirect, type Boolean, default True, access CSG
• XmNpopdownCallback — class XmCCallback, type XtCallbackList, default NULL, access C
• XmNpopupCallback — class XmCCallback, type XtCallbackList, default NULL, access C
• XmNsaveUnder — class XmCSaveUnder, type Boolean, default True, access CSG
• XmNvisual — class XmCVisual, type Visual *, default CopyFromParent, access CSG

🎀 Composite Resource Set 🎀

• XmNchildren — class XmCReadOnly, type WidgetList, default NULL, access G
• XmNinsertPosition — class XmCInsertPosition, type XtOrderProc, default NULL, access CSG
• XmNnumChildren — class XmCReadOnly, type Cardinal, default 0, access G

---

and bestie… that's only part 1 👀 there's MORE coming, don't go anywhere. 💖

Okay so the resource table. 💅 It's five whole columns wide — Name, Class, Type, Default, Access — and I am not making you squint at box-drawing characters in a terminal. So I flipped it vertical. Same nineteen entries, same values, char for char. Each one reads: name → class → type → default → access. Periodt.

---

✨ Core Resource Set ✨

• XmNaccelerators — class XmCAccelerators, type XtAccelerators, default dynamic, access CSG
• XmNancestorSensitive — class XmCSensitive, type Boolean, default dynamic, access G
• XmNbackground — class XmCBackground, type Pixel, default dynamic, access CSG
• XmNbackgroundPixmap — class XmCPixmap, type Pixmap, default XmUNSPECIFIED_PIXMAP, access CSG
• XmNborderColor — class XmCBorderColor, type Pixel, default XtDefaultForeground, access CSG
• XmNborderPixmap — class XmCPixmap, type Pixmap, default XmUNSPECIFIED_PIXMAP, access CSG
• XmNborderWidth — class XmCBorderWidth, type Dimension, default 0, access CSG
• XmNcolormap — class XmCColormap, type Colormap, default dynamic, access CG
• XmNdepth — class XmCDepth, type int, default dynamic, access CG
• XmNdestroyCallback — class XmCCallback, type XtCallbackList, default NULL, access C
• XmNheight — class XmCHeight, type Dimension, default dynamic, access CSG
• XmNinitialResourcesPersistent — class XmCInitialResourcesPersistent, type Boolean, default True, access C
• XmNmappedWhenManaged — class XmCMappedWhenManaged, type Boolean, default True, access CSG
• XmNscreen — class XmCScreen, type Screen *, default dynamic, access CG
• XmNsensitive — class XmCSensitive, type Boolean, default True, access CSG
• XmNtranslations — class XmCTranslations, type XtTranslations, default dynamic, access CSG
• XmNwidth — class XmCWidth, type Dimension, default dynamic, access CSG
• XmNx — class XmCPosition, type Position, default 0, access CSG
• XmNy — class XmCPosition, type Position, default 0, access CSG

Heads up bestie: the access codes are copied exactly as the original table gives them — CSG, G, CG, C — and no, I'm not editorialising on what each letter means. That's the spec's business, not mine. 🙈

---

🦋 Translations 🦋

Not me having to report this: there are no translations for OverrideShell. That's the whole thing. The translation table is empty. Nothing in it. Zero. 💀

---

🌈 RELATED 🌈

• Composite(3)
• Core(3)
• Shell(3)

---

And that's the page, bestie — the footer signs it off as OverrideShell(library call), which is literally the whole vibe: it's a library call, it lives in section 3, and it's done. 💖 Go forth and override, icon. 👑