sethbergman · June 23, 2019 07:42 · Jun 21, 2019 · Jun 21, 2019 · Jun 21, 2019
diff --git a/printargs.sh b/printargs.sh
@@ -1,10 +1,19 @@
 #!/usr/bin/env bash
 
-function printargs {
+#-------------------------------------------------------------------------------
+#
+#  print_args - easily inspect arguments passed to a bash script
+#
+#  sources:
+#    https://unix.stackexchange.com/a/332126/183920
+#
+#-------------------------------------------------------------------------------
+
+function print_args {
 
   echo "arguments:"
 
-  ii=1
+  local ii=1
   for arg; do
     printf "  \$%u: '%s'\n" "$ii" "$arg"
     ((ii++))
@@ -14,7 +23,7 @@ function printargs {
 
 # usage:
 #
-#   $ printargs 3 "3.a" "hello world"
+#   $ print_args 3 "3.a" "hello world"
 #   arguments:
 #     $1: '3'
 #     $2: '3.a'

diff --git a/printargs.sh b/printargs.sh
@@ -4,36 +4,39 @@ function printargs {
 
   echo "arguments:"
 
-  ii=0
+  ii=1
   for arg; do
-    printf "  %u: '%s'\n" "$ii" "$arg"
+    printf "  \$%u: '%s'\n" "$ii" "$arg"
     ((ii++))
   done
 
 }
 
 # usage:
 #
-#   $ source ex.sh
-#   $ printargs a b c
+#   $ printargs 3 "3.a" "hello world"
 #   arguments:
-#     0: 'a'
-#     1: 'b'
-#     2: 'c'
+#     $1: '3'
+#     $2: '3.a'
+#     $3: 'hello world'
 
-function another {
+function example {
 
-  echo "printing arguments passed to 'another'..."
+  echo "printing arguments passed to 'example'..."
   printargs "$@"
   echo "...done."
 
+  printf "\$2 = %s\n" "$2"
+
 }
 
 # example:
-#   $ another "g h" 1
-#   printing arguments passed to 'another'...
+#
+#   $ example "a b" 5.5 ho-ho
+#   printing arguments passed to 'example'...
 #   arguments:
-#     0: ''
-#     1: 'g h'
-#     2: '1'
-#   ...done.
+#     $1: 'a b'
+#     $2: '5.5'
+#     $3: 'ho-ho'
+#   ...done.
+#   $2 = 5.5
diff --git a/printargs.sh b/printargs.sh
@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+
+function printargs {
+
+  echo "arguments:"
+
+  ii=0
+  for arg; do
+    printf "  %u: '%s'\n" "$ii" "$arg"
+    ((ii++))
+  done
+
+}
+
+# usage:
+#
+#   $ source ex.sh
+#   $ printargs a b c
+#   arguments:
+#     0: 'a'
+#     1: 'b'
+#     2: 'c'
+
+function another {
+
+  echo "printing arguments passed to 'another'..."
+  printargs "$@"
+  echo "...done."
+
+}
+
+# example:
+#   $ another "g h" 1
+#   printing arguments passed to 'another'...
+#   arguments:
+#     0: ''
+#     1: 'g h'
+#     2: '1'
+#   ...done.