COINST-UPGRADES(1)

💖 COINST-UPGRADES(1) 💖

okay bestie, gather round, because this one is from the General Commands Manual and it is genuinely so useful 🫶

✨ NAME ✨

coinst-upgrades — finding upgrade issues between two versions of a Debian distribution 🌸

🦋 SYNOPSIS 🦋

coinst-upgrades [options] -o file control-file1 control-file2

👑 DESCRIPTION 👑

okay so here's the vibe: coinst-upgrades takes as input two Debian control files, and those two files are standing in for two versions of a Debian repository. Then it spits out a report listing every single package that could be installed together in the initial version of the repo (that's the one control-file1 is describing), and that can no longer be installed together in the final version of the repo (that's control-file2's whole thing). And — the best part — it also explains why they can't be installed together anymore. no cap, it just tells you 💅

and if your control files are compressed?? don't even stress, bestie, they get automatically uncompressed by the tool. it just handles it. main character energy ✨

🌈 OPTIONS 🌈

• --break sets — this one says: some packages do not have to be compatible anymore, and the matching issue should be omitted from the report entirely. the argument sets is a comma-separated list of sets of packages. each set is either a list of binary package names separated by a vertical bar symbol |, or a wildcard _ that stands for any package. we're gonna explain this one through examples because honestly that's the only way it clicks:
  • you can write --break libjpeg62-dev to state that the package libjpeg62-dev does not have to remain installable. periodt.
  • but it's usually better to say the package should stay installable, it's just fine if it's no longer installable with some other packages: --break libjpeg62-dev,_ 🎀
  • you can be even more precise and specify that two given packages can become incompatible, but that any other incompatibility should still be reported: --break parallel,moreutils
  • finally, you can use the vertical bar symbol to factorize several sets of packages: --break 'unoconv,python-uno|docvert-libreoffice' means that package unoconv does not have to remain installable together with python-uno nor docvert-libreoffice. iconic, honestly 🌟
• --debug name — activates the debug option called name. if you don't know what's available, run --debug help and it'll list all the available debug options for you 🧚
• -help, --help — prints a usage message briefly summarizing the command-line options. your lil bestie when you forget everything (it happens) 💜
• -o file — writes the report to this file. you literally need this, it's in the synopsis, it's not optional energy 👑
• --popcon file — uses popcon data from this file to order the issues. so your report comes out sorted by popularity, which is lowkey the glow-up your reading experience needed ⭐

🌸 AUTHOR 🌸

Coinst-upgrades has been written by Jérôme Vouillon. we stan 💖

💫 SEE ALSO 💫

• dot(1)
• The tool Web page: <http://coinst.irill.org/upgrades> — go look, iykyk 🦋

okay that's the whole page bestie!! this was COINST-UPGRADES(1) from the General Commands Manual, and that's a wrap on the whole thing 💅✨ go break some packages (with --break, obviously, not emotionally) 🎀🫶