ARCHPATH(1)

🌸 ARCHPATH(1) — the general commands manual, but make it cute 🌸

okay bestie, gather round, because archpath is one of those tiny little tools that does ONE thing and does it flawlessly, and honestly? we're obsessed. 💅

✨ NAME ✨

archpath — spits out arch (tla/Bazaar) archive names, and yes it handles branches too, because of course it does. 🦋

🎀 SYNOPSIS 🎀

archpath
archpath branch
archpath branch--version

three whole moods, that's the whole vibe. no flags, no chaos, just vibes. ✨

💖 DESCRIPTION 💖

so like. archpath is meant to be run inside an arch (tla or Bazaar) working copy. that's its whole home. its natural habitat. its main character setting. 🏠✨

in its simplest usage — literally just archpath with no parameters — it outputs the package name (archive/category--branch--version) that's associated with the working copy you're standing in. that's it. that's the tea. 🍓

now if you do give it a parameter, it can be one of two things:

• a branch--version — and then archpath will output a corresponding package name in the current archive and category 💫
• or a plain branch name (like, with no -- in it at all) — and then archpath will output a corresponding package name in the current archive and category, with the same version as the current working copy. no cap. 👑

and why do we care? because it's so useful for branching. for example, say you're using Bazaar and you want to create a branch for a new feature. you'd run something like this:

baz branch $(archpath) $(archpath new-feature)

or, say you want to tag your current code onto a releases branch as version 1.0. then you'd run something like this:

baz branch $(archpath) $(archpath releases--1.0)

and that is so much easier than using baz tree-version to go look up the package name and then manually edit the result like some kind of medieval peasant. 😭 we do not do manual editing in this house. periodt. 💅

👑 AUTHOR 👑

archpath was written by Colin Watson <cjwatson@debian.org>. 🫶

and like archpath itself, this manual page is released under the GNU General Public License, version 2 or later. slay, licensing. 📜✨

and that's the whole page, bestie — brought to you by the Debian Utilities crew, living under the DEBIAN banner, showing up in your manual as ARCHPATH(1) whenever you need it. go forth and branch responsibly. 🌈💜