CMDLINER-TOOL-COMPLETION(1)

💅 CMDLINER-TOOL-COMPLETION(1) — like, the whole manual, bestie

okay so this is a page from the Cmdliner Manual and it's genuinely so useful, so let's get into it ✨

🌸 NAME

cmdliner-tool-completion — spits out tool completion scripts, and honestly? iconic behavior.

🎀 SYNOPSIS

cmdliner tool-completion [--standalone-completion] [OPTION]… SHELL
TOOLNAME

yes bestie, that's two required little guys at the end: SHELL and TOOLNAME. no skipping them, periodt.

💖 DESCRIPTION

so cmdliner tool-completion outputs the tool specific completion script for a given shell. it's giving "here's exactly what you asked for." example, look:

cmdliner tool-completion zsh mytool

⚠️ important caveat though — not me forgetting to mention it: the tool specific completion script needs the corresponding generic completion script (the one output by generic-completion) to already be loaded in the shell. so it doesn't work all by itself in the normal case. and hey, if you wanna actually install these scripts, go look at command install tool-completion, iykyk 🫶

🦋 ARGUMENTS

• SHELL (required) — this is the shell you want to support, and it must be one of bash, zsh or pwsh. that's the whole list, fr fr. 💀
• TOOLNAME (required) — the name of the tool you want to complete. that's it, that's the vibe check.

✨ OPTIONS

• --standalone-completion — generates standalone completion scripts. these bad boys don't depend on the generic cmdliner completion scripts at all, which is lowkey great. but heads up: for some shells this may result in slower completion 😭 tradeoff city.

💅 COMMON OPTIONS

• --help[=FMT] (default=auto) — shows this help in format FMT. and FMT must be one of auto, pager, groff or plain. with auto, the format is pager or plain whenever the TERM env var is dumb or undefined. main character formatting moment 💫
• --version — shows version information. simple, slay, no notes.

🔥 EXIT STATUS

cmdliner tool-completion exits with:

1. 0 — on success 🎉
2. 123 — on indiscriminate errors reported on standard error 😬
3. 124 — on command line parsing errors 🙈
4. 125 — on unexpected internal errors (bugs) 💀

ngl 125 is the "not my fault, it's a bug" one. respect.

🌈 SEE ALSO

• cmdliner(1) — go read it, bestie, it's the whole fam 🫶

---

okay that's the whole page, no cap, every detail preserved 👑 and just so we're official about it: this is Cmdliner v2.1.1, mwah 💋 stay completed, bestie 🦋⭐💜