THEME_D_COMPILE(1)

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

💖 THEME_D_COMPILE(1) — the Theme-D Compiler, but make it a group chat 💖

okay bestie, sit down, hydrate, and let me tell you about theme-d-compile, the actual main character of the Theme-D Compiler manual. she lives in section 1 of the manual, she compiles your Theme-D code, and honestly? she ate. 🎀

✨ NAME ✨

theme-d-compile — the Theme-D compiler. that's it, that's her whole job description, and she's obsessed with it. 💅

🌈 SYNOPSIS 🌈

theme-d-compile [ OPTION ] ...  FILE

you give her some options, you give her a file, she does the thing. no cap. ✨

🦋 DESCRIPTION 🦋

so like, what she does is compile your Theme-D source file FILE into Theme-D pseudocode. literally that's the vibe. 🌸

now, the default output file name? it's not random, bestie, there's a whole system. you get it by replacing the suffix of the source file like this:

thp => tcp
ths => tcs
thi => tci
thb => tcb

iconic mapping, no notes. 🫶

and where does that output file go by default? into the directory where you invoked the command theme-d-compile. not somewhere mysterious, not in the shadow realm — right there where you were standing. 😌

💅 OPTIONS 💅

bestie, this is the part where she really shows out. one bullet per flag, every single one, let's go:

  • -o, --output=OUTPUTFILE — you wanna pick the compilation output file yourself? say less. this is how. 🎀
  • -m, --module-path=PATH — sets the search path for Theme-D modules. the path is a list of directories, and you separate them with :'s. cute extra: you can prefix the list with a colon so the default Theme-D library path gets folded into the search path too. 🧚
  • -u, --unit-type=TYPE — tells her what kind of unit you're compiling. the unit type has to be one of proper-program, script, interface, or body. pick one, those are the only ones, don't get creative. 👑
  • -l, --message-level=LEVEL — the compiler's message level. it has to be an integer number from 0 to 3. value 0 means no output at all (silence, mysterious, lowkey elegant), and value 3 is the most verbose output (she tells you EVERYTHING). 🗣️
  • --expand-only — do only macro expansion on the source. just the expansion, nothing else. 🌟
  • --no-expansion — compile the source without macro expansion. 🚫
  • --backtrace — print a backtrace when there's a compilation error. for when you need to know exactly where it went wrong, fr fr. 💀
  • --pretty-print — pretty print the pseudocode output. yes, your pseudocode can serve looks. ✨
  • --no-verbose-errors — less information in the error messages. short and sweet, we love a minimal queen. 🙈
  • --show-modules — show information about loading modules. 🍓
  • --macro-error-trace — display error trace for macro errors. macro drama gets its own receipts. 🧾
  • --version — display Theme-D version and exit. she introduces herself and dips. 💜

🌸 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, bestie, own it. 🎀

⭐ FILES ⭐

  • /etc/theme-d-config — the Theme-D configuration file. the system-wide one, the classic. 🏛️
  • ~/.theme-d-config — the Theme-D configuration file. heads up though: this file should normally only be present if you use Theme-D in local mode. so if you see it and you're not in local mode... side eye. 👀

🔥 SEE ALSO 🔥

go read these next, bestie, the lore is deep:

and that's the whole page, you're fully caught up. 🫶

this beauty is a GNU production, dated 2018-10-03, and it's the THEME_D_COMPILE(1) page. thanks for coming to my TED talk, go compile something iconic. 💖✨🎀

📦 where this page comes from