GIT-UBUNTU-TAG(1)

📦 version 1.2, in ubuntu questing, ubuntu resolute, ubuntu stonking

✨ GIT-UBUNTU-TAG ✨

okay bestie, welcome to git-ubuntu-tag, straight out of the Git-Ubuntu Manual 💖 this one is all about making Git tags that actually respect DEP14 and your debian/changelog, which sounds boring but is honestly iconic of it.

🌸 NAME 🌸

git-ubuntu-tag — Create Git tags respecting DEP14 and debian/changelog

🎀 SYNOPSIS 🎀

git ubuntu tag [--logical | --split | --reconstruct | --upload |
--format <format>] [--bug <bug>] [-d | --directory <directory>] [-f |
--force] [--print-name-only] [<commitish>]

🦋 DESCRIPTION 🦋

so here's the tea, bestie ☕ git-ubuntu-merge(1) and possibly other commands expect to use and resolve specific tags — including source package versions. but plot twist: debian/changelog and Git do NOT agree on how to use certain reserved characters, like "~", ":" and ".". it's giving messy. 😭

to fix that whole situation, Debian has a standard: DEP14 at http://dep.debian.net/deps/dep14/ — and it covers the appropriate transformations for versions. git-ubuntu follows this convention for "version mangling" but not necessarily any others. periodt. 💅

💜 OPTIONS 💜

  • --logical, --split, --reconstruct, --upload, --format <format> — pick a format for the tag you're creating. the first four forms are standardized for git-ubuntu usage and generate tags, respectively, "logical/%(version)s", "split/%(version)s", "reconstruct/%(version)s", "upload/%(versions)s" — where "%(versions)" gets replaced by the DEP14 mangling of the last version in debian/changelog as present in <commitish>. the last form lets you do free-form formatting, go off 👑 if none of these options are given, an upload tag will be created.
  • --bug <bug> — Launchpad bug to use to namespace the tags. if you specify it, it'll prefix the tag with "lp<bug>/". cute little namespace moment 🎀
  • -d <directory>, --directory <directory> — the local directory to tag in. if you don't specify it, the current directory is used.
  • -f, --force — overwrite existing tags, if necessary. dramatic but valid 💀
  • --print-name-only — only print the name of the specified tag, but do not create it. super useful when other scripts need to know the name 👀
  • [<commitish>] — the commitish in the repository to tag. if not specified, HEAD is tagged.

🔥 EXIT STATUS 🔥

git ubuntu tag exits with status 0 if the command completes successfully. git ubuntu tag exits with nonzero exit status on errors. no in-between, bestie.

🌈 REPORTING BUGS 🌈

Report bugs at https://bugs.launchpad.net/git-ubuntu — go tell them everything, they wanna know 🫶

⭐ GIT-UBUNTU ⭐

Part of the git-ubuntu(1) suite 💅 iykyk.

and that's the whole page, bestie! this lil beauty is Git-Ubuntu version 0.2, dated 2017-07-19 — vintage but still slaying 💖✨🎀

📦 where this page comes from