New Changelog, updated README, and the manpage.
authorviric@llimona
Tue, 03 Apr 2007 23:50:26 +0200
changeset 80 be0fb7e56061
parent 79 f99c2548fac4
child 81 4735cade8213
New Changelog, updated README, and the manpage.
Changelog
README
TODO
ts.1
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Changelog	Tue Apr 03 23:50:26 2007 +0200
@@ -0,0 +1,66 @@
+## Features to be implemented
+
+Doubtful tasks:
+ - Allow the 'only-tail' output, without any storage. The number of lines
+   or bytes should be choosable.
+   - No program should give that big amount of output, so it cannot be stored.
+
+ - What happens if the output disk is full? Should be decide a good behaviour
+   in that situation?
+ - Add a flag for not closing the input, and allow connecting a 'ts' client to
+   the blocked process. It may complicate the user interface more than needed.
+
+v0.4:
+ - Allow killing 'ts' in a nice way.
+   - It's good, because a spawner of 'ts' may want to kill it.
+ - If the server is horribly killed (it may happen as this is software), store
+   the task queue in a file, so it can be recovered.
+ - Allow inspecting the environment for a command queued: env, pwd., together
+   with other job queuing options (gzip, ...)
+ - Store the 'times()' for the run tasks.
+ - Use a better system than mkstemp() for finding output files, so we can add
+   .gz to the gzipped outputs.
+v0.3.1:
+ -* Fixed a bug with $POSIXLY_CORRECT being passed to the jobs. This break the
+   gentoo emerge jobs.
+ -* Fixed a posix compatibility problem for BSD.
+ -* Fixed - the fd 3 is no more opened for the task processes.
+ -* Added a man page and fixed the makefile.
+v0.3:
+ -* Allow sending the output by mail, or passing it to a program if an
+   env var defines it.
+ -* Allow gzipping the output
+ -* Add a flag for swapping two jobs in the queue (-U id-id)
+ -* Limit the jobs in 'finished' state according to $TS_MAXFINISHED
+ -* Output the jobid in stdout.
+ -* Status check with -s. Return the state in stdout.
+ -* An env var may define the socket path.
+ -* bash is no more used for running commands. Commands are run as is.
+v0.2.3:
+ -* '-nf' doesn't leave the job in 'finished' state
+ -* Fixed a bug in -r
+ -* '-u' implemented. For altering the queue order.
+ -* '-w' returns the waited errorlevel
+ -* '-o' returns the output file of the last job
+v0.2.1:
+ -* Fixed a bug in the wait-notifications.
+ -* Improved the compilation, including almost all the proper files.
+v0.2:
+ -* Add a '-h' for help
+ -* Have a nice list output (correctly formatted)
+ -* Allow killing the running job (Allowed with -p easily)
+ -* Allow tailing any job
+ -* Allow removing a job from the queue
+ -* Allow waiting any job
+v0.1:
+ -* The clients should _always_ go into background. *
+ -* Allow to receive more parameters in the command line, and them be joined
+   with spaces for the command passed to bash.
+ -* There should be no limit on command line parameters.
+ -* There should be no limit on lines outputed by "-l".
+ -* Get the list of finished jobs, with its errorlevel.
+ -* The list of finished jobs should be clenead on demmand "-c".
+ -* Output to a file should be possible. Use mkstemp().
+ -* There should be no limit on output filename.
+v0.0.1:
+ -* add tasks, and they run one after another. Input closed. Output in stdout.
--- a/README	Tue Apr 03 23:39:03 2007 +0200
+++ b/README	Tue Apr 03 23:50:26 2007 +0200
@@ -1,7 +1,15 @@
+Users
+------------------------
+If you are in a system which understands POSIX and has the GNU toolkit, you
+probably can run:
+ make
+ make install
+
+If you want to install to another path than /usr/local, you can run:
+ make install PREFIX=/usr
+
+
 Developers
 ------------------------
 Run ". setenv" before adding bugs to the database.
-Use 'bug' for the database.  http://freshmeat.net/cprojects/bug/
-
-The makefile is crap. Run "make clean", "make", to be sure everything is
-compiled correctly.
+Use 'bug' for the database.  http://freshmeat.net/projects/bug/
--- a/TODO	Tue Apr 03 23:39:03 2007 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,50 +0,0 @@
-## Features to be implemented
-
-Doubtful tasks:
- - Allow killing 'ts' in a nice way.
-   - It's good, because a spawner of 'ts' may want to kill it.
- - Allow the 'only-tail' output, without any storage. The number of lines
-   or bytes should be choosable.
-   - No program should give that big amount of output, so it cannot be stored.
-
- - What happens if the output disk is full? Should be decide a good behaviour
-   in that situation?
-
-v0.3:
- -* Allow sending the output by mail, or passing it to a program if an
-   env var defines it.
- -* Allow gzipping the output
- -* Add a flag for swapping two jobs in the queue (-U id-id)
- -* Limit the jobs in 'finished' state according to $TS_MAXFINISHED
- -* Output the jobid in stdout.
- -* Status check with -s. Return the state in stdout.
- -* An env var may define the socket path.
- -* bash is no more used for running commands. Commands are run as is.
-v0.2.3:
- -* '-nf' doesn't leave the job in 'finished' state
- -* Fixed a bug in -r
- -* '-u' implemented. For altering the queue order.
- -* '-w' returns the waited errorlevel
- -* '-o' returns the output file of the last job
-v0.2.1:
- -* Fixed a bug in the wait-notifications.
- -* Improved the compilation, including almost all the proper files.
-v0.2:
- -* Add a '-h' for help
- -* Have a nice list output (correctly formatted)
- -* Allow killing the running job (Allowed with -p easily)
- -* Allow tailing any job
- -* Allow removing a job from the queue
- -* Allow waiting any job
-v0.1:
- -* The clients should _always_ go into background. *
- -* Allow to receive more parameters in the command line, and them be joined
-   with spaces for the command passed to bash.
- -* There should be no limit on command line parameters.
- -* There should be no limit on lines outputed by "-l".
- -* Get the list of finished jobs, with its errorlevel.
- -* The list of finished jobs should be clenead on demmand "-c".
- -* Output to a file should be possible. Use mkstemp().
- -* There should be no limit on output filename.
-v0.0.1:
- -* add tasks, and they run one after another. Input closed. Output in stdout.
--- a/ts.1	Tue Apr 03 23:39:03 2007 +0200
+++ b/ts.1	Tue Apr 03 23:50:26 2007 +0200
@@ -171,6 +171,12 @@
 .B sh -c 'commands...'
 Also, remember that stdin/stdout/stderr will be detached, so
 don't use your shell's redirection operators when you put a job into background.
+
+The
+.B ts
+processes don't die very well. Take care not killing any of them, because they
+can bring the queue server down. It should be fixed in newer releases of this
+software.
 .SH SEE ALSO
 .BR at (1)
 .SH AUTHOR
@@ -178,4 +184,7 @@
 .SH NOTES
 This page describes
 .B ts
-as in version 0.3. Other versions my differ.
+as in version 0.3. Other versions my differ. The file
+.B TRICKS
+found in the distribution package can show some ideas on special uses of
+.B ts.