diff --git a/collects/handin-server/scribblings/checker.scrbl b/collects/handin-server/scribblings/checker.scrbl index b455d22c29..2d28eff46b 100644 --- a/collects/handin-server/scribblings/checker.scrbl +++ b/collects/handin-server/scribblings/checker.scrbl @@ -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.} diff --git a/collects/handin-server/scribblings/utils.scrbl b/collects/handin-server/scribblings/utils.scrbl index bbdcecb5c7..f4114eae0b 100644 --- a/collects/handin-server/scribblings/utils.scrbl +++ b/collects/handin-server/scribblings/utils.scrbl @@ -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)])