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

better text

Browse Source 
svn: r17459
This commit is contained in:
Eli Barzilay 2010-01-01 20:59:04 +00:00
parent 17937627e1
commit 3727ec4f9a
1 changed files with 18 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -142,21 +142,27 @@ Every exception or result mismatch during the call to
@defproc*[([(message [string string?]) void?] @defproc*[([(message [string string?]) void?]
[(message [string string?] [styles 'final]) void?] [(message [string string?] [styles 'final]) void?]
[(message [string string?] [(message [string string?]
[styles (listof (or/c 'ok 'ok-cancel 'yes-no 'caution 'stop))]) [styles (listof (or/c 'ok 'ok-cancel 'yes-no
'caution 'stop))])
any])]{ any])]{
The first two cases of @scheme[message] update the top-line of the status The first case of @scheme[message] is intended to update the client on
dialog on the client. If @scheme['final] is passed, then the the current activity --- it updates the status line in the submission
string argument is used as the as the text on the handin dialog box on the client. Use it to indicate operations that might
dialog after a successful submission instead of ``Handin take a while and/or indicate progress during these operations.
successful.'' (useful for submissions that were saved, but had
problems).
The third case, when @scheme[styles] is a list of symbols, In the second case, where @scheme['final] is used as a flag, does not
opens a @scheme[message-box] dialog on the client side, and the show the text immediately --- instead, it causes it to be displayed in
resulting value is returned as the result of @scheme[message]. The the status line after a successful submission instead of the usual
``Handin successful'' message. This is useful for submissions that
are accepted but had some problems.
The third case, when @scheme[styles] is a list of symbols, opens a
@scheme[message-box] dialog on the client side, and the resulting
value is returned as the result of @scheme[message]. The
@scheme[styles] list is passed as the @scheme[style] argument to @scheme[styles] list is passed as the @scheme[style] argument to
@scheme[message-box]. You @scheme[message-box]. You can use this to send warnings to the
can use this to send warnings to the student or ask confirmation.} student or to ask for confirmation, for example, ``your submission
does not pass 3 tests, continue?''.}
@defproc[(set-run-status [status (or/c false? string?)]) void?]{ @defproc[(set-run-status [status (or/c false? string?)]) void?]{
Registers information about the current actions of the checker, in Registers information about the current actions of the checker, in