ubuntu-dev-tools(5)

✨ ubuntu-dev-tools ✨

okay so bestie, welcome to ubuntu-dev-tools(5), a File Formats Manual page, and it's literally all about how you configure the ubuntu-dev-tools package. buckle up 💖

💅 NAME 💅

ubuntu-dev-tools — the configuration sitch for the ubuntu-dev-tools package, periodt.

🌸 DESCRIPTION 🌸

so ubuntu-dev-tools is basically devscripts(1)'s cousin — same vibe, similar scope. it hands you a whole lil collection of scripts that are genuinely useful if you're an Ubuntu or Debian developer, or honestly just anyone who wants to build Debian packages. main character energy fr fr 🫶

some of these scripts have options you can configure system-wide and per-user. those options live in devscripts.conf(5). yes, that's the spot. no cap.

every single variable is described in the script's own manpages, but the package-wide ones all start with "UBUNTUTOOLS" and they're listed below for you. 👑

and here's the lil escape hatch: every script that reads the config files can be forced to straight-up ignore them by using the --no-conf command-line option. iconic. 🎀

🌈 ENVIRONMENT 🌈

plot twist: all ubuntu-dev-tools configuration variables can be set (and overridden!) by setting them in the environment. that's different from devscripts, bestie — note it. ✨

plus, a few scripts also use these environment variables:

• UBUMAIL — overrides DEBEMAIL and DEBFULLNAME when the target is clearly Ubuntu. it can hold either an e-mail address, or the whole Full Name <email@example.org> situation. 💌
• DEBEMAIL, DEBFULLNAME — same as in devscripts(1). that's it, that's the tea. 🍓

👑 PACKAGE-WIDE VARIABLES 👑

these are the package-wide variables that are currently recognised:

• UBUNTUTOOLS_BUILDER — picks your preferred test-builder. one of pbuilder (default), sbuild, pbuilder-dist. choose your fighter 🥊
• UBUNTUTOOLS_DEBIAN_MIRROR — your preferred Debian archive mirror. should be of the form http://ftp.debian.org/debian (no trailing slash, bestie, i mean it). if you don't specify it, the master gets used.
• UBUNTUTOOLS_DEBSEC_MIRROR — your preferred Debian security archive mirror. should be of the form http://security.debian.org (no trailing slash again 🚫). not specified? the master it is.
• UBUNTUTOOLS_UBUNTU_MIRROR — your preferred Ubuntu archive mirror. form: http://archive.ubuntu.com/ubuntu (no trailing slash ✋). leave it blank and the master steps in.
• UBUNTUTOOLS_UBUNTU_PORTS_MIRROR — the preferred Ubuntu archive mirror (yes, it says archive mirror again, we're keeping it exactly as-is 💀). form: http://ports.ubuntu.com (no trailing slash). unset? master, always the master.
• UBUNTUTOOLS_LPINSTANCE — the Launchpad instance to communicate with. e.g. production (default) or staging. pick your portal 🌀
• UBUNTUTOOLS_MIRROR_FALLBACK — whether or not to fall-back to the master archive mirror. this is usually the behaviour you want, because mirrors can lag behind the masters. but if you're on a private network with only a local mirror, you might wanna set this to no. one of yes (default) or no.
• UBUNTUTOOLS_UPDATE_BUILDER — whether or not to update the test-builder before every single test build. one of yes or no (default).
• UBUNTUTOOLS_WORKDIR — the directory used for preparing source packages and all that jazz. when it's unset, it defaults to a directory inside /tmp/ named after the script. cute lil auto-naming moment 🧚

🦋 SEE ALSO 🦋

devscripts(1), devscripts.conf(5)

💜 AUTHORS 💜

this manpage was written by Stefano Rivera <stefanor@ubuntu.com>. give them their flowers 💐

ok that's the whole page bestie, go configure something slay 💅✨

signing off — ubuntu-dev-tools, December 19 2010, from the ubuntu-dev-tools(5) era. mwah 🫶💖