ALR-PUBLISH(1)

✨ alr-publish — the Alire manual, bestie edition ✨

okay so this is the page for alr-publish(1), straight out of the Alire manual (the man page is literally titled ALR-PUBLISH(1), in case you were wondering). she helps you publish a new release 🎀 and she is so much less scary than she looks. let's get into it 💅

---

🌸 NAME 🌸

alr-publish — help with the publication of a new release

---

🦋 SYNOPSIS 🦋

alr publish [options] [--skip-build] [--tar] [--manifest <file>] [<URL>
[commit]]]

that's the whole vibe. options, then optionally skip the build, optionally make a tar, optionally point at a different manifest, optionally hand her a <URL> and maybe a commit. mix and match, she's flexible 💖

---

✨ OPTIONS ✨

• --manifest=ARG — picks a manifest file that is not ./alire.toml. like, you have a different toml and you want her to use that one instead. go off, custom girl 🫶
• --tar — wakes up the publishing assistant so she builds a source archive out of a local directory. the "i have files right here, package them up" route 🌈
• --trusted-sites — just prints you a list of the trusted git repository sites. no publishing, no ceremony, just the list 👑
• --skip-build — skips the build check step. yes, the check. she's not going to build-verify for you, so know what you're doing 🙈

---

💜 GLOBAL OPTIONS 💜

these ones are the everywhere-options, the ones that work across the whole alr universe, not just publishing:

• -c, --config=ARG — overrides where the configuration folder lives. want your config somewhere else? say it here ✨
• -f, --force — keeps going after a recoverable troublesome situation. like, "yeah i know, push through anyway" energy 💀
• -h, --help — shows general help, or help specific to whatever command you typed. the classic save-me button 🆘
• -n, --non-interactive — assumes the default answer for every single prompt. no questions asked, literally 🌸
• --no-color — turns off colors in the output. for when your terminal aesthetic is monochrome 🖤
• --no-tty — disables control characters in output. good for pipes and logs and places that do not want fancy business 🎀
• --prefer-oldest — when resolving dependencies, prefers the oldest versions instead of the newest. vintage queen 🍓
• --version — displays the version and dips out immediately 👋
• -q — limits output to errors only. quiet mode, mysterious mode 🦋
• -v — be more verbose. use it twice for extra detail. yes bestie, stack them ⭐
• -d, --debug[] — enables debug-specific log messages. for when you need to see everything 🔥

---

🌈 DESCRIPTION 🌈

she checks a release and generates an index manifest. that's the core gig, no cap 💅

the full details live at https://github.com/alire-project/alire/blob/master/doc/publishing.md

so about that <URL> — it's an optional path to a remote source archive, or a local or remote git repository. she takes all of those 🫶

for the common use case of a github-hosted repository: issue alr publish after committing and pushing the new release version. commit first, push first, then publish. order matters, iykyk ✨

• use --tar to create a source archive that's ready to be uploaded 📦
• use --manifest to use metadata that lives in a non-default file 🗂️

and for help with all the other scenarios, go check that link up above 👆 she said what she said.

---

👀 SEE ALSO 👀

• alr(1)
• gprbuild(1)

---

🎀 AUTHOR 🎀

Generated with generate-man from Alire execution. iconic behaviour, honestly.

---

heads up bestie: --skip-build literally skips the build check step, so please don't be shocked when the build check doesn't happen 💀

---

okay that's the whole page!! this was Alire 1.2, dated Aug 3, 2022 — she's a little vintage but she ate, periodt 💖✨🦋