Updated manpage and help.
authorviric@mandarina
Mon, 24 Dec 2007 20:51:18 +0100
changeset 159 76293ced27b5
parent 158 d449f07c7609
child 160 8b40ee19e765
Updated manpage and help.
main.c
ts.1
--- a/main.c	Mon Dec 24 20:37:32 2007 +0100
+++ b/main.c	Mon Dec 24 20:51:18 2007 +0100
@@ -314,7 +314,6 @@
     printf("  -w [id]  wait for a job. The last added, if not specified.\n");
     printf("  -u [id]  put that job first. The last added, if not specified.\n");
     printf("  -U <id-id>  swap two jobs in the queue.\n");
-    printf("  -L <label>  name this task, to be distinguished on listing.\n");
     printf("  -h       show this help\n");
     printf("  -V       show the program version\n");
     printf("Options adding jobs:\n");
@@ -323,6 +322,7 @@
     printf("  -f       don't fork into background.\n");
     printf("  -m       send the output by e-mail (uses sendmail).\n");
     printf("  -d       the job will be run only if the job before ends well\n");
+    printf("  -L <lab> name this task with a label, to be distinguished on listing.\n");
 }
 
 static void print_version()
--- a/ts.1	Mon Dec 24 20:37:32 2007 +0100
+++ b/ts.1	Mon Dec 24 20:51:18 2007 +0100
@@ -21,10 +21,12 @@
 .BI "[\-r ["id ]]
 .BI "[\-w ["id ]]
 .BI "[\-u ["id ]]
+.BI "[\-i ["id ]]
 .BI "[\-U <"id - id >]
+.BI "[\-L <"label >]
 .sp
 Options:
-.BI "[\-nfgm]"
+.BI "[\-nfgmd]"
 
 .SH DESCRIPTION
 .B ts
@@ -68,6 +70,16 @@
 .B /usr/sbin/sendmail.
 Look at
 .B ENVIRONMENT.
+.TP
+.B "\-L <label>"
+Add a label to the task, which will appear next to its command when listing
+the queue. It makes more comfortable distinguishing similar commands with
+different goals.
+.TP
+.B "\-d"
+Run the command only if the command before finished well (errorlevel = 0). This new
+task enqueued depends on the result of the previous command. If the task is not run,
+it's considered as failed for further dependencies.
 .SH ACTIONS
 Instead of giving a new command, we can use the parameters for other purposes:
 .TP
@@ -121,6 +133,11 @@
 Make the named job (or the last in the queue) urgent - this means that it goes
 forward in the queue so it can run as soon as possible.
 .TP
+.B "\-i [id]"
+Show information about the named job (or the last run). It will show the command line,
+some times related to the task, and also any information resulting from
+\fBTS_ENV\fR (Look at \fBENVIRONMENT\fR).
+.TP
 .B "\-U <id-id>"
 Interchange the queue positions of the named jobs (separated by a hyphen and no
 spaces).
@@ -188,6 +205,12 @@
 .B ts
 command run), on SIGTERM the queue status will be saved to the file pointed
 by this environment variable - for example, at system shutdown.
+.TP
+.B "TS_ENV"
+This has a command to be run at enqueue time through
+\fB/bin/sh\fR. The output of the command will be readable through the option
+\fB\-i\fR. You can use a command which shows relevant environment for the command run.
+For example, you may use \fBTS_ENV='pwd;set;mount'\fR.
 .SH FILES
 .TP
 .B /tmp/ts.error