1VIS-COMPLETE(1)           BSD General Commands Manual          VIS-COMPLETE(1)
2

NAME

4     vis-complete — Interactively complete file or word
5

SYNOPSIS

7     vis-complete [--file] [--word] [--] [pattern]
8
9     vis-complete -h | --help
10

DESCRIPTION

12     vis-complete takes a pattern on the command-line and completes file or
13     word and displays them in a menu for the user to select one.  Once the
14     user has selected a completion, the completion (excluding the pattern) is
15     printed to standard output.
16
17     vis-complete uses vis-menu(1) as its user-interface, so see that page for
18     more details.
19
20     --file
21           This passes pattern to find to obtain a list of matching file
22           names.
23
24     --word
25           This reads standard input to obtain a list of lines matching
26           pattern.
27
28     --    If this token is encountered before the first non-option argument,
29           all following arguments will be treated as pattern, even if they
30           would otherwise be valid command-line options.
31
32           If encountered after the first non-option argument, or after a pre‐
33           vious instance of -- it is treated as a pattern.
34
35     pattern
36           The pattern to be completed by file or word.
37
38     -h | --help
39           If present, vis-complete prints a usage summary and exits, ignoring
40           any other flag and arguments.
41

EXIT STATUS

43     The vis-complete utility exits 0 on success, and >0 if an error occurs.
44
45     In particular, like vis-menu(1), vis-complete prints nothing and sets its
46     exit status to 1 if the user refused to select a file.
47

SEE ALSO

49     vis(1), vis-menu(1)
50

BUGS

52     Because vis-complete uses find(1) to obtain the list of files, weird
53     things might happen if you have control-characters in your filenames.
54
55Vis v0.5                       January 15, 2017                       Vis v0.5