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?]
[(message [string string?] [styles 'final]) void?]
[(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])]{
The first two cases of @scheme[message] update the top-line of the status
dialog on the client. If @scheme['final] is passed, then the
string argument is used as the as the text on the handin
dialog after a successful submission instead of ``Handin
successful.'' (useful for submissions that were saved, but had
problems).
The first case of @scheme[message] is intended to update the client on
the current activity --- it updates the status line in the submission
dialog box on the client. Use it to indicate operations that might
take a while and/or indicate progress during these operations.
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
In the second case, where @scheme['final] is used as a flag, does not
show the text immediately --- instead, it causes it to be displayed in
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[message-box]. You
can use this to send warnings to the student or ask confirmation.}
@scheme[message-box]. You can use this to send warnings to the
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?]{
Registers information about the current actions of the checker, in