tipstack(3tk)

📦 version 0.9, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 tipstack — Stacked tooltips 💖

okay bestie, welcome to tipstack, from the tklib fam. it's the tipstack(3tk) page, it lives under "Tooltip management," and it's genuinely one of the cutest little packages you'll ever meet. let's get into it 🫶

✨ NAME ✨

tipstack — Stacked tooltips. that's it, that's the whole name, and honestly? iconic. 👑

✨ SYNOPSIS ✨

first up, the vibes check — you gotta have your prerequisites lined up before any of this slays:

package require Tcl 8.5

package require msgcat 1.3

package require tooltip ?1.7?

package require tipstack ?1.0.1?

and here are the commands you're getting, all lined up and ready:

::tipstack::push widget ?-index index? text

::tipstack::pop widget ?-index index?

::tipstack::clear widget ?-index index?

::tipstack::def widget text ...

::tipstack::defsub base widget text ...

::tipstack::clearsub base

✨ DESCRIPTION ✨

so this package is literally an extension of the tooltip package. it gives you a dynamic stack of tip texts per widget 💅 — yes, per widget, and yes, a whole stack.

what does that mean for you? it means you can do dynamic, transient changes to the tips. like, say you've got a field with a nice standard explanation of what it does, and then boom — an error message shows up. instead of nuking your original tip forever, you just stack the error on top. when the error's gone, you pop it off and your OG explanation is right back. it's giving ✨graceful✨. it's giving main character energy. it's giving "my tooltip has layers." 🦋

✨ COMMANDS ✨

`::tipstack::push widget ?-index index? text`

pushes a brand new text onto the tooltip stack for the widget. stacking queen behavior. 👑

in case of a list widget, use:

-index ...

to point at the tooltip you mean.

the result of the command is the empty string. yes bestie, it returns nothing. that's normal, don't panic.

`::tipstack::pop widget ?-index index?`

pops the current tooltip off the stack for the widget and restores the previous text. like undoing a message in the group chat. 💀

important: this is a no-operation if popping would leave an empty stack behind. in other words, the baseline tooltip text cannot be popped off. the baseline is sacred. periodt.

in case of a list widget, use:

-index ...

to point at the tooltip you mean.