DH_BASH-COMPLETION(1)

✨ NAME ✨

okay so bestie, this is the manual page for dh_bash-completion — a debhelper situation that installs bash completions for your package 💅

---

✨ SYNOPSIS ✨

dh_bash-completion [debhelper options]

---

✨ DESCRIPTION ✨

so like. dh_bash-completion is a debhelper program and its whole job — its entire main character purpose — is installing completions for bash 🐚✨ the ones you can actually use once you've installed the bash-completion package.

to actually get it working you gotta pass --with bash-completion over to debhelper, and also Build-depend on bash-completion. both. no skipping one, bestie, it's giving "two-step vibe check" 🫶

if a file named debian/package.bash-completion exists, then different things happen depending on what format that file is in. it's giving "read the room, the format decides everything" 😭

it can be a proper completion snippet! in which case it just gets installed into the completion directory, and literally nothing else happens. that's it. periodt. 🎀

it can also be a list of files, each one optionally with a name you want the completion snippet to be called after. here's what that format looks like:

my/path/to/foo-completion       # this would be installed as "foo-completion"
my/path/to/bar-completion  baz  # this would be installed as "baz"

see how the second one gets renamed? yeah. iconic behaviour 🌸

---

✨ SEE ALSO ✨

• debhelper(1) 👑
• this program is a part of bash-completion, iykyk 💜
• bash(1) 🦋

---

✨ AUTHOR ✨

David Paleino <d.paleino@gmail.com> — the legend, the blueprint, we stan 🌈⭐

---

and that's the whole page bestie!! this was version 2.16.0, dated 2025-12-18, coming to you straight from the Bash-Completion Debhelper crew 💖 now go install some completions, you absolute queen 👑💅