suzanne.soy/racket
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

some more stuff about text related options

Browse Source 
svn: r11862
This commit is contained in:
Eli Barzilay 2008-09-25 00:34:23 +00:00
parent d981ea63ec
commit 516647216d
1 changed files with 21 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
collects/handin-server/scribblings/checker.scrbl
View File

@ -1,6 +1,9 @@
#lang scribble/doc #lang scribble/doc
@(require "common.ss") @(require "common.ss")
@define[textoption]{(Effective only when saving a textual version of
the submission files: when @scheme[:create-text?] is on.)}
@title{checker} @title{checker}
@defmodulelang[handin-server/checker]{ @defmodulelang[handin-server/checker]{
@ -28,10 +31,15 @@ language module---a typical checker that uses it looks like this:
(code:line :key val keys-n-vals)])]{ (code:line :key val keys-n-vals)])]{
Constructs (and provides) an appropriate checker function, using Constructs (and provides) an appropriate checker function, using
keywords for features that you want, the body of the checker can keywords to customize features that you want it to have. The body of
contain arbitrary code, using all utilities from the checker (following the keywords) can contain arbitrary code, using
@schememodname[handin-server/utils], as well as additional ones (see utility functions from @schememodname[handin-server/utils], as well as
below).} additional ones that are defined below. Submission files are arriving
to the handin server in binary form (in the MrEd format that is used
to store text and other objects like images), and a number of these
options involve genrating a textual version of this file. The purpose
of these options is to have these text files integrate easily into a
course framework for grading, based on these text files.}
Keywords for configuring @scheme[check:]: Keywords for configuring @scheme[check:]:
@ -75,8 +83,7 @@ Keywords for configuring @scheme[check:]:
are converted to text, trying to convert objects like images and are converted to text, trying to convert objects like images and
comment boxes to some form of text. Defaults to @scheme[#f], comment boxes to some form of text. Defaults to @scheme[#f],
meaning that an exception is raised for submissions that are not all meaning that an exception is raised for submissions that are not all
text. (Effective only when saving a textual version of the text. @textoption
submission files: when @scheme[:create-text?] is on.)
This flag is effective only when saving a textual version of the This flag is effective only when saving a textual version of the
submission files --- when @scheme[:create-text?] is on. The submission files --- when @scheme[:create-text?] is on. The
@ -100,14 +107,12 @@ Keywords for configuring @scheme[check:]:
to spaces, assuming a standard tab width of 8 places. This is to spaces, assuming a standard tab width of 8 places. This is
needed for a correct computation of line lengths, but note that needed for a correct computation of line lengths, but note that
DrScheme does not insert tabs in Scheme mode. Defaults to DrScheme does not insert tabs in Scheme mode. Defaults to
@scheme[#t]. (Effective only when saving a textual version of the @scheme[#t]. @textoption}
submission files: when @scheme[:create-text?] is on.)}
@item{@indexed-scheme[:maxwidth]---a number that specifies maximum @item{@indexed-scheme[:maxwidth]---a number that specifies maximum
line lengths for submissions (a helpful feature for reading student line lengths for submissions (a helpful feature for reading student
code). Defaults to 79. This feature can be disabled if set to code). Defaults to 79. This feature can be disabled if set to
@scheme[#f]. (Effective only when saving a textual version of the @scheme[#f]. @textoption}
submission files: when @scheme[:create-text?] is on.)}
@item{@indexed-scheme[:output]---the name of the original handin file @item{@indexed-scheme[:output]---the name of the original handin file
(unrelated to the text-converted files). Defaults to (unrelated to the text-converted files). Defaults to
@ -127,13 +132,14 @@ Keywords for configuring @scheme[check:]:
@item{@indexed-scheme[:markup-prefix]---used as the prefix for @item{@indexed-scheme[:markup-prefix]---used as the prefix for
@scheme[:student-lines] and @scheme[:extra-lines] below. The @scheme[:student-lines] and @scheme[:extra-lines] below. The
default is @scheme[";;> "] or @scheme["//> "], depending on the default is @scheme[";;> "] or @scheme["//> "], depending on the
suffix of @scheme[:output] above. (Note: if you change this, make suffix of @scheme[:output] above. Note: if you change this, make
sure to change @scheme[:prefix-re] too.)} sure to change @scheme[:prefix-re] too. @textoption}
@item{@indexed-scheme[:prefix-re]---used to identify lines with markup @item{@indexed-scheme[:prefix-re]---used to identify lines with markup
(@scheme[";>"] or @scheme["//>"] etc), so students cannot fool the (@scheme[";>"] or @scheme["//>"] etc), so students cannot fool the
system by writing marked-up code. The default is @scheme[";>"] or system by writing marked-up code. The default is @scheme[";>"] or
@scheme["//>"], depending on the suffix of :output above.} @scheme["//>"], depending on the suffix of :output above.
@textoption}
@item{@indexed-scheme[:student-line]---when a submission is converted @item{@indexed-scheme[:student-line]---when a submission is converted
to text, it begins with lines describing the students that have to text, it begins with lines describing the students that have
@ -143,14 +149,14 @@ Keywords for configuring @scheme[check:]:
which requires @scheme["Full Name"] and @scheme["Email"] entries in which requires @scheme["Full Name"] and @scheme["Email"] entries in
the server's extra-fields configuration. These lines are prefixed the server's extra-fields configuration. These lines are prefixed
with @scheme[";;> "] or the prefix specified by with @scheme[";;> "] or the prefix specified by
@scheme[:makup-prefix] above.} @scheme[:makup-prefix] above. @textoption}
@item{@indexed-scheme[:extra-lines]---a list of lines to add after the @item{@indexed-scheme[:extra-lines]---a list of lines to add after the
student lines, all with a @scheme[";;> "] or :markup-prefix too. student lines, all with a @scheme[";;> "] or :markup-prefix too.
Defaults to a single line: Defaults to a single line:
@scheme["Maximum points for this assignment: <+100>"]. (Can use @scheme["Maximum points for this assignment: <+100>"]. (Can use
@scheme["{submission}"] for the submission directory.) See also @scheme["{submission}"] for the submission directory.) See also
@scheme[add-header-line!].} @scheme[add-header-line!]. @textoption}
@item{@indexed-scheme[:user-error-message]---a string that is used to @item{@indexed-scheme[:user-error-message]---a string that is used to
report an error that occurred during evaluation of the submitted report an error that occurred during evaluation of the submitted