RUN_THEME_D_PROGRAM(1)

📦
version 7.3.3 · 2 versions
, in ubuntu resolute, ubuntu stonking

💖 run-split-theme-d-program 💖

okay bestie, welcome to the run-theme-d-program manual, section 1 (that's the general commands girlies ✨). this whole page is about one iconic little script and how to make it run your Theme-D program. let's get into it 🎀

🌸 NAME 🌸

run-split-theme-d-program — literally just run a Theme-D program with a split target. that's the whole vibe 💅

✨ SYNOPSIS ✨

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

no cap, that's the shape of it 🦋

🫶 DESCRIPTION 🫶

so like, the command run-split-theme-d-program runs the Theme-D program in PROGRAMFILE, which has been linked into split Guile bytecode files. yes bestie, split. that's the whole point of this one 😌

here's the little division of labour that makes it all work:

  • the METAARG arguments? those get handled by the run-split-theme-d-program script itself. she's the main character, she takes care of her own business 👑
  • the PROGRAMARG arguments? those get passed straight through to the Theme-D program. not her problem, not her drama 🙈

so anything before PROGRAMFILE is for the script, anything after is for your program. simple as 💖

💅 OPTIONS 💅

  • --no-verbose-errors — turns OFF the verbose info about errors (exceptions). you're in your quiet era 🤫
  • --backtrace — shows a backtrace when a runtime error happens. receipts, basically 🧾
  • --pretty-backtrace — shows a pretty printed backtrace on error. glow-up version of the backtrace ✨
okay important bestie, listen: --pretty-backtrace only works if you linked your Theme-D program with the option --runtime-pretty-backtrace. if you didn't do that, it's giving nothing. no pretty for you 😭

🌈 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. you're overriding the default, periodt 💜
  • THEME_D_CUSTOM_CODE — a list of Guile bytecode files to be loaded before the Theme-D program is run. the filenames shall be separated with colons. colon-separated, don't forget 🍓

🎀 FILES 🎀

  • /etc/theme-d-config — the Theme-D configuration file. the system-wide one 💫
  • ~/.theme-d-config — the Theme-D configuration file. this file should normally be present only if you use Theme-D in local mode. local mode girlies only 🧚

👑 SEE ALSO 👑

go read these too, they're all in the family:

and that's the whole page, bestie!! this was brought to you by GNU, dated 2020-05-14 — yeah she's a little vintage but she still eats 💖 mwah, go run your program, ily, bye 🫶✨

📦 where this page comes from