RUN_THEME_D_PROGRAM_M(1)

💖 RUN_THEME_D_PROGRAM_M(1) 💖

okay bestie, welcome to the run-theme-d-program-m manual page — it's section 1 of the manual, and it's literally all about running a modularly linked Theme-D program. yes. that's the whole job. she's a one-trick pony and she ATE. 💅

---

✨ NAME ✨

run-theme-d-program-m — run a modularly linked Theme-D program 🦋

---

✨ SYNOPSIS ✨

run-theme-d-program-m [ METAARG ] ...  PROGRAMFILE [ PROGRAMARG ] ...

---

✨ DESCRIPTION ✨

so here's the tea 🍓: the command run-theme-d-program-m runs a Theme-D program called PROGRAMFILE, linked modularly into Guile bytecode.

now — and this is the part people get confused about — the args split into two little teams:

• METAARG args get handled by the run-theme-d-program-m script itself. she deals with those, not your program. 💅
• PROGRAMARG args get passed straight through to your Theme-D program. those are hers to keep, bestie. 🫶

---

✨ OPTIONS ✨

• -g PATH — set the target library path. that's it, that's the whole vibe. 🌸
• --no-verbose-errors — no verbose info about errors (exceptions). keeping it lowkey. 🤫
• --backtrace — display a backtrace on runtime error. we love receipts. 🔥
• --pretty-backtrace — display a pretty printed backtrace on error. okay but heads up bestie, this one only works if you linked your Theme-D program with the option --runtime-pretty-backtrace. no link, no pretty. 🎀
• --version — display backtrace on runtime error.

not me noticing that --version says it displays a backtrace on runtime error 💀 that's what the page says, so that's what we're telling you. no edits, no notes, periodt. ✋

---

✨ ENVIRONMENT ✨

• THEME_D_CONFIG_FILE — if this variable is defined, its value gets used as the Theme-D configuration file instead of the default configuration file. your file, your rules. 👑
• THEME_D_CUSTOM_CODE — a list of Guile bytecode files to be loaded before the Theme-D program runs. separate the filenames with colons. (: bestie, not commas, iykyk 🧚)

---

✨ FILES ✨

• /etc/theme-d-config — the Theme-D configuration file. 🏠
• ~/.theme-d-config — the Theme-D configuration file. this one should normally be present only if you use Theme-D in local mode. so if it's just... chilling there and you're not in local mode? side eye. 🙈

---

✨ SEE ALSO ✨

go read these too, they're all iconic in their own way 💜

• run-theme-d-program(1)
• theme-d-compile(1)
• theme-d-link(1)
• setup-theme-d-test-env(1)
• /usr/share/doc/theme-d-doc/theme-d-user-guide.pdf.gz

---

reminder that METAARGs stay with the script and PROGRAMARGs go to your program. do not mix them up. i'm not mad, i'm just disappointed. 😭

---

GNU 🌈 2025-08-18 — that's the source and the date, bestie, so go forth and run your modularly linked Theme-D program. slay, have fun, don't forget the colons in THEME_D_CUSTOM_CODE. mwah. 💖✨🎀🦋🌸💅🫶👑⭐