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

Add xrefs and advice re Robby

Browse Source
This commit is contained in:
Jay McCarthy 2013-04-04 07:36:36 -06:00
parent 0cbf694468
commit 2bd19d1604
4 changed files with 11 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
collects/web-server/scribblings/lang-api.scrbl
View File

@ -22,13 +22,13 @@ A stateless servlet should @racket[provide] the following exports:
} }
@defthing[stuffer (stuffer/c serializable? bytes?)]{ @defthing[stuffer (stuffer/c serializable? bytes?)]{
This is the stuffer that will be used for the servlet. This is the @tech{stuffer} that will be used for the servlet.
If it is not provided, it defaults to @racket[default-stuffer]. If it is not provided, it defaults to @racket[default-stuffer].
} }
@defthing[manager manager?]{ @defthing[manager manager?]{
This is the manager that will be used for the servlet. This is the @tech{manager} that will be used for the servlet.
If it is not provided, it defaults to @racket[(create-none-manager #f)]. If it is not provided, it defaults to @racket[(create-none-manager #f)].
} }

2
collects/web-server/scribblings/managers.scrbl
View File

@ -8,7 +8,7 @@ up memory on the server. Furthermore, garbage collection can not be used
to free this memory, because there are roots outside the system: users' to free this memory, because there are roots outside the system: users'
browsers, bookmarks, brains, and notebooks. Therefore, some other strategy browsers, bookmarks, brains, and notebooks. Therefore, some other strategy
must be used if memory usage is to be controlled. This functionality is must be used if memory usage is to be controlled. This functionality is
pluggable through the manager interface. pluggable through the @deftech{manager} interface.
@; ------------------------------------------------------------ @; ------------------------------------------------------------
@section[#:tag "manager"]{General} @section[#:tag "manager"]{General}

2
collects/web-server/scribblings/servlet.scrbl
View File

@ -19,7 +19,7 @@ A stateful servlet should @racket[provide] the following exports:
} }
@defthing[manager manager?]{ @defthing[manager manager?]{
The manager for the continuations of this servlet. See @secref["managers"] for options. The @tech{manager} for the continuations of this servlet. See @secref["managers"] for options.
} }
@defproc[(start [initial-request request?]) @defproc[(start [initial-request request?])

10
collects/web-server/scribblings/stateless-usage.scrbl
View File

@ -1,6 +1,7 @@
#lang scribble/doc #lang scribble/doc
@(require "web-server.rkt" @(require "web-server.rkt"
(for-label racket/serialize (for-label racket/serialize
web-server/lang/stuff-url
web-server/lang/abort-resume web-server/lang/abort-resume
web-server/lang/web)) web-server/lang/web))
@ -49,9 +50,12 @@ Second, the defunctionalization process is sensitive to the syntactic
structure of your program. Therefore, if you change your program in a structure of your program. Therefore, if you change your program in a
trivial way, for example, changing a constant, then all serialized trivial way, for example, changing a constant, then all serialized
continuations will be obsolete and will error when deserialization is continuations will be obsolete and will error when deserialization is
attempted. This is a feature, not a bug! It is a small price to pay for attempted. This is a feature, not a bug! It is a small price to pay
protection from the sorts of errors that would occur if your program for protection from the sorts of errors that would occur if your
were changed in a meaningful way. program were changed in a meaningful way. If you use the
@racket[default-stuffer] or @racketmodname[web-server/stuffers/hash],
then whenever you change your servlet's code, you can safely delete
all saved continuations, because they won't be used any longer.
Third, the values in the lexical scope of your continuations must be Third, the values in the lexical scope of your continuations must be
serializable for the continuations itself to be serializable. This means serializable for the continuations itself to be serializable. This means