NAME¶

SYNOPSIS¶

DESCRIPTION¶

vis-open uses vis-menu(1) as its user-interface, so see that page for more details.

-p prompt

Display prompt before the list of items. This is passed straight through to vis-menu(1).

-f

Normally, if vis-open is provided with a single filename or directory argument, it will automatically select it (printing the filename to standard output, or presenting a new menu with the contents of the directory). If -f is provided, vis-open will always present the arguments it's given, even if there's only one.

--

If this token is encountered before the first non-option argument, all following arguments will be treated as menu-items, 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 menu-item.

files

File and directory names to be presented to the user. If a name does not exist on the filesystem and the user selects it, it is treated as a file.

-h | --help

If present, vis-open prints a usage summary and exits, ignoring any other flag and arguments.

EXIT STATUS¶

In particular, like vis-menu(1), vis-open prints nothing and sets its exit status to 1 if the user refused to select a file.

EXAMPLES¶

CHOICE=$(vis-open -p "Select a file to stat")
if [ $? -gt 0 ]; then
	echo "No selection was made, or an error occurred"
else
	stat "$CHOICE"
fi

SEE ALSO¶

BUGS¶