VIS-COMPLETE(1)

💅 vis-complete(1) 💅

okay bestie, welcome to the General Commands Manual page for vis-complete(1) 💖 this one is short, useful, and honestly kinda iconic.

---

🌸 NAME 🌸

vis-complete — interactively complete a file or a word, no cap 🦋

---

✨ SYNOPSIS ✨

vis-complete [--file | --word] [--] pattern

vis-complete -h | --help

---

💖 DESCRIPTION 💖

okay so here's the vibe: vis-complete takes a pattern from the command-line, completes a file or a word, and shows the matches in a menu so the user can pick one. Once the user has selected a completion, the completion — excluding the pattern — is printed to standard output. slay 💅

it uses vis-menu(1) as its user-interface, so go peek at that page for more details, iykyk 🫶

🎀 the flags & args, bestie 🎀

• --file — this passes pattern to find to obtain a list of matching file names (this is the default) 🔥
• --word — this reads standard input to obtain a list of lines matching pattern ✨
• -- — an argument following this token will be treated as pattern, even if it would otherwise be a valid command-line option. If -- is encountered after a previous instance of --, it is treated as a pattern 👑
• pattern — the pattern to be completed by file or word 🌸
• -h | --help — if present, vis-complete prints a usage summary and exits, ignoring any other flag and arguments 💖

---

🦋 EXIT STATUS 🦋

the vis-complete utility exits 0 on success, and >0 if an error occurs 💀

in particular, like vis-menu(1), vis-complete prints nothing and sets its exit status to 1 if the user refused to select a file. not me getting ignored by the menu 😭

---

🌈 SEE ALSO 🌈

go say hi to vis(1) and vis-menu(1) — they're right there in SEE ALSO, bestie 🫶

---

💀 BUGS 💀

because vis-complete uses find(1) to obtain the list of files, weird things might happen if you have control-characters in your filenames. fr fr, control-characters in filenames = chaos vibes 🙈

---

mwah 💋 this whole page is Vis v0.9-531-gd89b6c27-dirty, dated March 21, 2023, and it's the VIS-COMPLETE(1) page — periodt 🫶