daemon: Implement 'set_variables' (atomic set multiple variables) call.
[whenjobs.git] / tools / whenjobs.pod
index 0f777d4..466bdb1 100644 (file)
@@ -29,6 +29,7 @@ Examine running jobs:
  whenjobs --jobs
  whenjobs --cancel serial
  whenjobs --start "name"
+ whenjobs --tail serial
 
 =head1 DESCRIPTION
 
@@ -149,13 +150,6 @@ source, eg:
 
  whenjobs --lib $builddir/lib -e
 
-=item B<--start> "job name"
-
-Start the job immediately and unconditionally.
-
-This runs the job even if its normal preconditions are not met.  This
-may cause unexpected results, so use with caution.
-
 =item B<--set> variable value
 
 =item B<--type> bool|int|float|string|unit
@@ -176,6 +170,18 @@ variable when setting it by adding the optional I<--type> parameter:
 See the discussion of variable types in the L</REFERENCE> section
 below.
 
+=item B<--start> "job name"
+
+Start the job immediately and unconditionally.
+
+This runs the job even if its normal preconditions are not met.  This
+may cause unexpected results, so use with caution.
+
+=item B<--tail> serial
+
+Tail the output of the running job identified by its serial number.
+Use the I<--jobs> flag to get a list of running jobs.
+
 =item B<--upload>
 
 Compile the jobs script and upload it to the daemon, without editing.