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

doc clarifications

Browse Source 
svn: r11961
This commit is contained in:
Eli Barzilay 2008-10-07 14:14:23 +00:00
parent 0899471d32
commit 9f3161cf24
2 changed files with 14 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -65,13 +65,16 @@ Keywords for configuring @scheme[check:]:
evaluating submissions, same as the @scheme[_language] argument for
@scheme[make-evaluator] (see @schememodname[handin-server/sandbox]).
There is no default for this, so it must be set or an error is
raised.}
raised. (See @scheme[call-with-evaluator/submission] for further
details.)}
@item{@indexed-scheme[:requires]---paths for additional libraries to
require for evaluating the submission, same as the
@scheme[_requires] argument for @scheme[make-evaluator] (see
@schememodname[handin-server/sandbox]). This defaults to null---no
teachpacks.}
teachpacks. Note: if a module language is used (See
@scheme[call-with-evaluator/submission] for further details), it is
passed as the @scheme[_allow-read] argument.}
@item{@indexed-scheme[:teachpacks]---an alternative name for
@scheme[:requires], kept for legacy checkers.}

15
collects/handin-server/scribblings/utils.scrbl
View File

@ -36,7 +36,10 @@
list that begins with @scheme['module]. In this case,
@scheme[make-module-language] is used to create an evaluator, and
the module code must be using the the specified language in its
language position.}
language position. In this case, the @scheme[requires-paths]
argument is used only for paths that are allowed to be accessed (the
@scheme[_allow-read] argument to @scheme[make-evaluator], since the
submission is expected to be a complete submission.)}
@defproc[(call-with-evaluator
[language (or/c module-path?
@ -58,11 +61,11 @@
submission error. See @scheme[make-evaluator/submission] for
further details.}
@defproc[(call-with-evaluator/submission [language
(or/c module-path?
(list/c (one-of/c 'special) symbol?)
(list/c (one-of/c 'module) module-path?)
(cons/c (one-of/c 'begin) list?))]
@defproc[(call-with-evaluator/submission
[language (or/c module-path?
(list/c (one-of/c 'special) symbol?)
(list/c (one-of/c 'module) module-path?)
(cons/c (one-of/c 'begin) list?))]
[require-paths (listof path-string?)]
[submission bytes?]
[proc (any/c . -> . any)])