Manual/Running-Jobs.md

@@ -11,10 +11,12 @@ Parameters following the `job` are specific to the job, and will be validated by
 minicoin. Any parameters after a double dash `--` following the machine names
 will be passed on to the job's `main` script without any validation. For example,
 
-`$ minicoin run --repeat 2 build --target tst_qstring_check ubuntu2004 -- --testargs toUpper`
+`$ minicoin run --repeat 2 build --target tst_qstring_check ubuntu2004`
 
 This command will run the `build` job for target `tst_qstring_check` two times
-on the ubuntu2004 machine, passing also `--testargs toUpper` through to the job.
+on the ubuntu2004 machine.  Some jobs support trailing options as well, e.g.
+
+`$ minicoin run ctest ubuntu2004 -- -L corelib/kernel`
 
 For all jobs, the directory on the guest that maps to the current working
 directory on the host, and the current working directory on the host, are passed
@@ -36,18 +38,16 @@ For a list of available jobs, run
 
 `$ minicoin run --help`
 
-Which parameters the job supports depends on each job. To see the documentation
-for a job, run
+Which parameters the job supports depends on each job, and a properly implemented
+job also provides help text. To see the documentation for a job, run
 
 `$ minicoin run [job] --help`
 
-The most important job is:
+E.g.
 
-`$ minicoin run build [machines...]`
+`$ minicoin run build --help`
 
-This job builds the local source tree on the listed machines. The local
-source tree can be a toplevel Qt repo, a single Qt module, or a Qt project.
-The Qt toolkit from the last build of qtbase will be used.
+will inform about the command line arguments the `build` job supports.
 
 # Run options