Improve commenting/exit handling in binscripts

1 files changed, 9 insertions, 1 deletions

diff --git a/bin/rndf b/bin/rndf
index 6918dbea..06e15fbe 100755
--- a/bin/rndf
+++ b/bin/rndf
@@ -1,9 +1,17 @@
 #!/bin/sh
-# Choose a random file from a given directory using rnda(1). Ignores dot files.
+# Choose a random file from a given directory using rnda(1); ignores dot files
+
+# Directory is first argument; defaults to current directory
 dir=${1:-.}
+
+# Set the positional parameters to all the non-dotfiles in that directory
 set -- "$dir"/*
+
+# Check for an unexpanded glob (empty directory)
 if ! [ -e "$1" ] ; then
     printf >&2 'rndf: No files found in %s\n' "$dir"
     exit 1
 fi
+
+# Print a random argument from the current positional parameters
 rnda "$@"