blt::bltdebug(3tcl)

✨ NAME ✨

bltdebug — bestie, it prints your Tcl commands before they even run 💅

🎀 SYNOPSIS 🎀

bltdebug ?level?

🦋 DESCRIPTION 🦋

okay so bltdebug is literally the simplest little tracing facility for Tcl commands, and she is that girl for when you're like "wait what is even happening in here" 🔍✨

Every command line gets printed before it's executed, and it goes to standard error — not stdout, bestie, keep your actual output clean 🌸

The output is giving ✨ both ✨ — you get the command line before substitutions have occurred and after substitutions have occurred. So you can see what you typed and what Tcl turned it into. Obsessed, honestly 😭

• level — this tells it at what level to stop tracing commands.
  • If level is 0, no tracing is performed at all. And yes, that's the default — she's off until you ask, no cap 🙈
  • If you don't give a level argument at all? Then the current level is printed instead. Just a lil vibe check on where you're at 👑

ngl, level is the whole entire personality of this command. Set it, or don't — but know that 0 means silence and no argument means "tell me where I'm at" 🫶

👑 KEYWORDS 👑

debug

that's the whole page, bestie — go trace some commands and slay 💖

🌸 this one's from the BLT Built-In Commands manual, BLT version 2.5, filed under blt::bltdebug(3tcl) — mwah, periodt 💅🎀