release-build(1)

✨ release-build(1) ✨

okay bestie, welcome to release-build — a manpage from the bikeshed manual, and honestly? it's giving "convenient little helper script" energy 💅

---

💖 NAME 💖

release-build — the convenient lil script for "building" an upstream project, right before it gets released to Ubuntu 🫶

---

🌸 SYNOPSIS 🌸

release-build

that's it. no flags, no args. she's simple like that ✨

---

🎀 ASSUMPTIONS 🎀

so, this script — and its partner in crime, release(1) — need a whole specific set of project parameters to actually work right. no cap. here's the checklist:

• The project must use bzr(1) and http://launchpad.net
• The project name, [FOO], must match its Launchpad project, http://launchpad.net/[FOO]
• There must be a corresponding Launchpad team, also matching the same name, http://launchpad.net/~[FOO]
• The team must have a PPA activated, named "ppa"
• The project must use a MAJOR.MINOR versioning scheme

lowkey that's a lot of musts. like, every single one is a must. read them again bestie, i'll wait 💀

---

🦋 DESCRIPTION 🦋

This script will work on a bzr(1) branch with debian packaging in the current directory. and then she does the most:

• automatically determine the project/package name and version by parsing the debian/changelog file
• clean out the build-area
• create an original tarball
• check the original tarball for common mistakes
• build a local binary deb
• build a set of source packages, for each of a set of supported Ubuntu releases

after she's done all of that? she prints the next steps straight to your screen so you can copy-and-paste them, because she's a giver 💖. those steps include:

• the command to install the package locally (for testing)
• the release command, to move on and make it official
• also the command to revert the changes to the debian/changelog

---

🌈 EXAMPLES 🌈

wanna see sample projects/packages that use the release and release-build commands for publishing? here's the lineup, and yes they all ate:

• bikeshed
• byobu
• ecryptfs
• musica
• pictor
• powernap
• screenbin
• testdrive

---

🔥 SEE ALSO 🔥

release(1), bzr(1), dpkg(1)

---

👑 AUTHOR 👑

This manpage and the utility was written by Dustin Kirkland <kirkland@ubuntu.com> for Ubuntu systems (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL, or on the web at http://www.gnu.org/licenses/gpl.txt.

---

and that's the whole page bestie, ty for coming to my ted talk 🧚 from the bikeshed manual, dated 6 Oct 2010 — periodt 💜