scripts: make option listing more consistent

vis-clipboard

@@ -13,9 +13,12 @@ vc_usage() {
 
 Copy/paste clipboard interface with support on all provided platforms.
 
-Available selections: clipboard, primary
-
-Example: $(basename "$0") --copy --selection primary"
+Options:
+    --copy       copy text from standard input
+    --paste      paste text to standard output
+    --usable     silently exit with a status code indicating if a supported
+                 clipboard implementation was found
+    --selection  take input from sel. valid options: clipboard, primary"
 }
 
 vc_determine_command() {

vis-complete

@@ -11,11 +11,10 @@ usage() {
 
 Interactively complete file or word
 
---file this passes pattern 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.
-pattern pattern to be completed"
+Options:
+    --file   expand pattern into a list of matching file names (default)
+    --word   apply pattern to a list of words from standard input
+    pattern  pattern to be completed"
 }
 
 basic_regex_quote() { printf "%s" "$1" | sed 's|[\\.*^$[]|\\&|g'; }

vis-open

@@ -15,9 +15,10 @@ usage() {
 
 Interactively select a file to open
 
--f always present the given arguments, even when there is only one
--p prompt
-file-pattern list of filenames and directories"
+Options:
+    -f            always present given arguments, even when there is only one
+    -p            use prompt as prompt string
+    file-pattern  list of filenames and directories"
 }
 
 # print a list of filenames on stdin and distinguish directories