From ea52bc06ad2d0417ea4fc52c3cf54cd966393bb2 Mon Sep 17 00:00:00 2001 From: Eli Barzilay Date: Wed, 24 Sep 2008 19:02:34 +0000 Subject: [PATCH] more clarifications svn: r11854 --- .../handin-server/scribblings/checker.scrbl | 35 ++++++++++++++----- 1 file changed, 27 insertions(+), 8 deletions(-) diff --git a/collects/handin-server/scribblings/checker.scrbl b/collects/handin-server/scribblings/checker.scrbl index e825ecd847..4f9519cded 100644 --- a/collects/handin-server/scribblings/checker.scrbl +++ b/collects/handin-server/scribblings/checker.scrbl @@ -71,6 +71,31 @@ Keywords for configuring @scheme[check:]: printouts and grading, and is in a subdirectory so students will not see it on the status web server. Defaults to @scheme[#t].} +@item{@indexed-scheme[:textualize?]---if true, then all submissions + are converted to text, trying to convert objects like images and + comment boxes to some form of text. Defaults to @scheme[#f], + meaning that an exception is raised for submissions that are not all + text. (Effective only when saving a textual version of the + submission files: when @scheme[:create-text?] is on.) + + This flag is effective only when saving a textual version of the + submission files --- when @scheme[:create-text?] is on. The + possible configurations are: + @itemize[ + @item{@scheme[:create-text?] is on and @scheme[:textualize?] is off + (the default) --- in this case a text version of submissions is + created, and submissions must contain only plain text. The text + file has the same semantics of the submission and can be used to + run student code.} + @item{@scheme[:create-text?] is off --- allowing submissions that + contain non-textual objects, but no text file is created so + grading and testing must be done using DrScheme (because the saved + submission is always in binary format).} + @item{Both flags are on --- allowing submission with non-textual + objects and generating text files, but these files will not be + usable as code since objects like images cannot be represented in + plain text.}]} + @item{@indexed-scheme[:untabify?]---if true, then tabs are converted to spaces, assuming a standard tab width of 8 places. This is needed for a correct computation of line lengths, but note that @@ -78,13 +103,6 @@ Keywords for configuring @scheme[check:]: @scheme[#t]. (Effective only when saving a textual version of the submission files: when @scheme[:create-text?] is on.)} -@item{@indexed-scheme[:textualize?]---if true, then all submissions - are converted to text, trying to convert objects like comment boxes - and test cases to some form of text. Defaults to @scheme[#f], - meaning that an exception is raised for submissions that are not all - text. (Effective only when saving a textual version of the - submission files: when @scheme[:create-text?] is on.)} - @item{@indexed-scheme[:maxwidth]---a number that specifies maximum line lengths for submissions (a helpful feature for reading student code). Defaults to 79. This feature can be disabled if set to @@ -95,7 +113,8 @@ Keywords for configuring @scheme[check:]: (unrelated to the text-converted files). Defaults to @filepath{hw.scm}. (The suffix changes the defaults of @scheme[:markup-prefix] and @scheme[:prefix-re].) Can be - @scheme[#f] for removing the original file after processing.} + @scheme[#f] for removing the original file after processing. The + file is always stored in MrEd's binary format.} @item{@indexed-scheme[:multi-file]---by default, this is set to @scheme[#f], which means that only DrScheme is used to send