feat(up/bkt-read_stdin_psarg):add bash func to read stdin and posarg

[BK-2020-03.git] / unitproc / bktemp-count_jobs

diff --git a/unitproc/bktemp-count_jobs b/unitproc/bktemp-count_jobs
index cf262341bdf1c4e1cf37aef7ed72235e8bcbd62e..9bde32d45519bde29e035e45ad6f4c242034aa36 100644 (file)
--- a/unitproc/bktemp-count_jobs
+++ b/unitproc/bktemp-count_jobs
@@ -9,6 +9,14 @@ 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
 count_jobs() {
+    # Desc: Count and return total number of jobs
+    # Usage: count_jobs
+    # Input: None.
+    # Output: stdout   integer number of jobs
+    # Depends: Bash 5.1.16
+    # Example: while [[$(count_jobs) -gt 0]]; do echo "Working..."; sleep 1; done;
+    # Version: 0.0.1
+    
     local job_count;
     job_count="$(jobs -r | wc -l | tr -d ' ' )";
     #yell "DEBUG:job_count:$job_count";