BOTCH-CLEAN-REPOSITORY(1)

✨ BOTCH-CLEAN-REPOSITORY 💖

okay bestie, welcome to the botch-clean-repository manual page — it lives in the botch tools section of the manual, and it's genuinely one of the most satisfying little utilities out there. it's giving spring cleaning but for Debian repos. 🧹✨

---

🌸 NAME 🌸

botch-clean-repository — clean errors in a repository by removing transitively uninstallable or compilable packages

---

🦋 SYNOPSIS 🦋

botch-clean-repository [options] Packages Sources

---

💅 DESCRIPTION 💅

so here's the vibe: you hand it a repository of binary packages and source packages, and it cleans up that repository by yeeting the stuff that just doesn't work. specifically it removes:

• packages that can't be compiled or installed
• packages that don't have an associated binary or source package
• packages that don't match the specified architecture

and the result? it effectively creates a self contained repository of maximal size. like, the biggest possible repo that still actually works. no cap. 👑

---

✨ OPTIONS ✨

• --version — show the program's version and then dip. bye! 👋
• -h, --help — show this help message and exit. classic.
• -v, --verbose — print additional information. spill the tea, we want details 💬
• --quiet — do no print any messages. (yes, the original says "do no print" and honestly? iconic. keeping it exactly as-is.) 🤫
• --reqsrcarchall — require source packages for arch:all binary packages
• --addsrcarchall — add source packages which only build arch:all binary packages
• --deb-drop-b-d-indep — Drop Build-Depends-Indep dependencies
• --deb-drop-b-d-arch — Drop Build-Depends-Arch dependencies
• --allowsrcmismatch — If a binary package is without a source package but there is a source package of same name but different version, match this binary package to that source package. (a little matchmaking, we love to see it 💘)
• --progress — print progress bars. loading bar ASMR 🫶
• -o, --outfile=FILE — Set the output file FILE
• --deb-native-arch=ARCH — Native architecture ARCH
• --deb-host-arch=arch — Host architecture arch. Defaults to native architecture.
• --deb-foreign-archs=archs — Comma-separated foreign architectures in addition to native and host architectures.
• --deb-ignore-essential — By default, installing any binary package requires the coinstallation set of all binary packages marked as Essential:yes to be installed as well. This option drops this requirement.

---

🎀 EXAMPLE 🎀

Clean up a repository:

botch-clean-repository --deb-native-arch=amd64 packages sources > packages-clean
botch-bin2src --deb-native-arch=amd64 packages-clean sources > sources-clean

see how botch-clean-repository feeds straight into botch-bin2src? pipeline slay. 🔥

---

💀 BUGS 💀

See <http://bugs.debian.org/botch>.

---

🌈 SEE ALSO 🌈

Debian doc-base Manual /usr/share/doc/botch/wiki/Home.html

---

👑 AUTHOR 👑

This man page was written by Johannes Schauer. Botch is written by Johannes Schauer and Pietro Abate. (shoutout to the devs fr fr 🙌)

---

📜 COPYRIGHT 📜

Copyright 2012-2014 Johannes Schauer, Pietro Abate

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. A special linking exception to the GNU Lesser General Public License applies to this library, see the COPYING file for more information.

---

ok that's the whole page bestie, go forth and clean some repositories 💖

perl v5.36.0 · 2023-02-17 — mwah, that's a wrap, BOTCH-CLEAN-REPOSITORY(1) out 💅✨🦋