DUNE-PROMOTION(1)

💅 dune-promotion — the manual page, but make it make sense

okay so bestie, imagine this: your build makes changes, and somebody has to tell those changes to go back home to your actual source code. that's literally what dune-promotion does. no cap. it's the lil' command that controls how changes get propagated back to source code. 🦋

it lives in the Dune Manual, section 1 (that's the user commands section, iykyk).

---

✨ SYNOPSIS ✨

dune promotion COMMAND …

so yeah — you run dune promotion, then you pick a COMMAND, then whatever that command wants. it's giving choose-your-own-adventure but for your source tree. 💖

---

🎀 COMMANDS 🎀

• apply [OPTION]… [FILE]… — promotes those files from the last run. it's the "okay we're doing this for real" one. 🫶
• diff [OPTION]… [FILE]… — lists the promotions that are going to be applied. the "let me see the vibes first" one, lowkey the responsible choice. ✨
• list [OPTION]… [FILE]… — lists promotion files. just the list. iconic, minimal, no notes. 💅
• show [OPTION]… [FILE]… — displays the contents of a corrected file. peek at the glow-up before you commit to it. 👑

---

🌸 COMMON OPTIONS 🌸

• --help[=FMT] (default=auto) — shows this help in format FMT. and FMT has to be one of exactly these: auto, pager, groff, or plain. and when you pick auto? the format ends up being pager or plain whenever the TERM env var is dumb or undefined. that's the whole rule, fr fr. 🍓
• --version — shows version information. the classic. ⭐

---

💀 EXIT STATUS 💀

dune promotion exits with:

1. 0 — on success. ate. slay. 💖
2. 1 — if an error happened. 😭
3. 130 — if it was interrupted by a signal. dramatic, but real. 💀

---

🔥 SEE ALSO 🔥

• dune(1) — the main character. go read that one too. 🌈

---

ok one tiny note bestie: OPTION and FILE show up as … for a reason — the manual says [OPTION]… [FILE]…, so don't be reading extra meanings into it, just know that's the shape. 🧚

that's the whole page, you understood it, periodt. 💜

this has been your girl walking you through the Dune Manual, dune-promotion(1), as shipped with Dune 3.24.1 — go promote something cute. 🎀✨