DTFPLIST(1)

💖 dtfplist, the front-panel hierarchy printer — from the user cmd manual 💖

okay bestie, welcome to dtfplist from the user cmd manual — she's giving general purpose utility energy and she's here to print front panel hierarchy tea. 💅

---

✨ NAME ✨

dtfplist — a general purpose utility for printing the hierarchy of the front panel components. That's the whole name card, no cap. 🫶

🦋 SYNOPSIS 🦋

dtfplist

🌸 DESCRIPTION 🌸

okay so dtfplist gives you a textual view of what the front panel will look like — and the iconic part? It does this without restarting the window manager. Obsessed. 😭

It provides the ability to get an ASCII text version of the front panel hierarchy, and it will print that hierarchy to standard out. That's the gig, bestie. ✨

🎀 OPTIONS 🎀

None. Literally zero flags — no options to memorize, no little letters to collect. 💀

💜 OPERANDS 💜

None. No operands, no extra args, nada. 🦋

⭐ RESOURCES ⭐

None. Not a single resource in sight. 💅

🍓 STDIN 🍓

Not used. She's not reading stdin, bestie — that's not her main character moment. 🙈

🌈 INPUT FILES 🌈

None. Zero, zilch, no input files. 🫶

🧚 ENVIRONMENT VARIABLES 🧚

DTDATABASESEARCHPATH — that's the one env var in the group chat. 👑

💀 ASCHRONOUS EVENTS 💀

None. (Yes, that's the section spelling on the page — keeping it exactly, bestie. 💅)

🌟 STDOUT 🌟

Here's the format of the hierachy that gets written to standard out — their spelling, not mine, love that for them 😭:

PANEL &<panel name>
        BOX &<box name>
                CONTROL &<control name>
                        SUBPANEL &<subpanel name>
                                CONTROL &<control name>
                                        ...
                CONTROL &<control name>
                        ...
        BOX &<box name>
                ...

The hierarchy that will be written to standard out is the one that will be used when the front panel is created during the invocation of dtwm. That's the important little detail, no cap. 🔥

🦋 STDERR 🦋

Not used. She's not spilling anything to stderr. 🎀

🌸 OUTPUT FILES 🌸

None. She's only doing standard out business. ✨

💜 EXTENDED DESCRIPTION 💜

None. Nothing extra in the extended description lane. 💅

⭐ EXIT STATUS ⭐

None. That's what the page says, bestie. 🫶

🍓 CONSEQUENCES OF ERRORS 🍓

⚠️ if DTDATABASESEARCHPATH is not specified, this utility will not generate any output. That's the error consequence, plain and simple — no output, no tea. 😭

🌈 APPLICATION USAGE 🌈

This can be used to debug changes to the front panel configuration files. Debugging slay. 🔍✨

🧚 EXAMPLES 🧚

None. No examples in the chat today, bestie. 💀

👑 SEE ALSO 👑

dtwm(1) — go check that one too. 💖

---

💌 source/version: dtfplist(user cmd) · date: not shown in the footer, bestie — so that's the whole sign-off tea. mwah! 💅✨