scripts: make option listing more consistent

3 files changed, 14 insertions, 11 deletions

diff --git a/vis-clipboard b/vis-clipboard
index 0f9e90b..769c96d 100755
--- a/vis-clipboard
+++ b/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() {
diff --git a/vis-complete b/vis-complete
index 50895b1..2e76499 100755
--- a/vis-complete
+++ b/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'; }
diff --git a/vis-open b/vis-open
index bcd555a..fd3e63f 100755
--- a/vis-open
+++ b/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