keepFile — Request printing of a file generated by runTests or computeMarks.
keepFile {file} { maxlines | option | } [option...]
Called from within a computeMarks script, which would in turn have been called by rst. Used to request that a file generated by runTests or computeMarks be printed. For files submitted by the student, use printFile instead.
The file parameter specifies the filename of
the file to be printed. The filename may be relative to
tmpdir, or it may be an absolute path.
maxlines is the maximum number of lines to
print; if the file is longer than the specified length, it is
truncated. If maxlines is omitted, a copy of
the indicated file is kept for later inspection after the testing run
finishes, but the file is not printed.
options are optional and may be used to specify
certain behaviour. If more than one option is provided, the whole set
of options may be enclosed in quotation marks for backwards
compatibility with an older version of keepFile, but this is not
required or recommended. The options are as follows:
Don't show line numbers.
Fold long lines (instead of truncating at the right margin). Using -f is important as having lines truncated can make marking very difficult.
Not yet implemented! Wrap long lines; like fold, except it tries to break at a word boundary.
name"Override the output header for this file to something other than the default filename header.
keystring"
Primarily for use with deProcessFile.
Specify that the key for this file should be something other
than what was provided in the file
parameter.
Specifies that the file is an EPS file and should be scaled to fit a full page as closely as possible.
params"
Specifies that the file is an EPS file, and that it should be
sized according to the LaTeX code
params. An example would be:
-e 'height=0.4\textheight,width=0.9\textwidth,keepaspectratio'
As part of the process of preparing the file for printing, it is transformed into a LaTeXed version that must be saved for inclusion in the final LaTeX produced for the assignment. An attempt has been made to handle a handful of special characters in a way that makes LaTeX interpret them properly, but there is no guarantee of success for many non-alphanumeric characters.