Interactively complete file or word
vis-complete takes a pattern on the command-line and
completes file or word and displays them in a menu for the user to select one.
Once the user has selected a completion, the completion (excluding the
pattern) is printed to standard output.
vis-menu(1) as its user-interface, so see that page for
- This passes pattern to
to obtain a list of matching file names.
- This reads standard input to obtain a list of lines matching
- If this token is encountered before the first non-option argument, all
following arguments will be treated as pattern, even if they would
otherwise be valid command-line options.
If encountered after the first non-option argument, or after a
previous instance of
-- it is treated as a
- The pattern to be completed by file or word.
- If present,
vis-complete prints a usage summary
and exits, ignoring any other flag and arguments.
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.
vis-complete uses find(1) to
obtain the list of files, weird things might happen if you have
control-characters in your filenames.