Description

There are several options available from the command-line to the RST family of commands.

-t

This should be followed by a series of letters which indicate the type of RST output that is being generated. This can be any combination of the following three:

p Postscript f PDF t Text

In addition, the single letter c can be specified. This indicates that not only should all types of output be generated, but every other file generated by RST in the temporary directory should also be kept in the results directory for future examination. This option should be used with care, and only on small numbers of students at a time.

-s

This should be followed by a single parameter: a set of whitespace-delimited glob patterns that will be shell-expanded to determine what set of students the command being run should apply to.

-o

This should be followed by a single parameter, representing the location in the filesystem that will be used for output of this command. What the output represents varies by command; in the case of marmocreate it's a zip file of the tests which should be run by Marmoset, whereas in the case of distrst it's a directory which will contain logs for all of the rst runs performed.

-v

This is followed by a number indicating which version of RST's command line conventions should be assumed for all of the following command line arguments. Currently, this will need to be either 1 or 2.

-d

This option gives a command-line hook into all of the behaviour that can be specified in .rstrc. It is followed by a parameter of the form variable = value which will then be interpreted inside of the command's context.