chore(bktemp-yellDieTry):Add version, comments
[BK-2020-03.git] / unitproc / bktemp-yellDieTry
index 4295aff8bb38c55ddfb3b9764f989c0891672a18..fafa168b6803bca3acdc66919eed97f392d08c7e 100644 (file)
@@ -1,16 +1,18 @@
 #!/bin/bash
 # Desc: Defines bash functions yell(), die(), and try(), which are useful for
 #   indicating where in a script an error occurs.
+# Note: All three functions should be added together if used at all.
 # Ref/Attrib: [1] Yell, Die, Try Three-Fingered Claw technique https://stackoverflow.com/a/25515370
 # Depends: GNU Coreutils 8.30
+# Version 0.1.1
 
 #==BEGIN Define script parameters==
 #==END Define script parameters==
 
 #===BEGIN Declare local script functions===
-yell() { echo "$0: $*" >&2; }
-die() { yell "$*"; exit 111; }
-try() { "$@" || die "cannot $*"; }
+yell() { echo "$0: $*" >&2; } # print script path and all args to stderr
+die() { yell "$*"; exit 111; } # same as yell() but non-zero exit status
+try() { "$@" || die "cannot $*"; } # runs args as command, reports args if command fails
 #===END Declare local script functions===
 
 #==BEGIN sample code==