steve
/
factor
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

http.server: tweak docs

db4
Slava Pestov 2010-06-28 17:31:45 -04:00
parent 350a6522c7
commit 0bea14dcd5
1 changed files with 6 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
basis/http/server/server-docs.factor
View File

@ -70,7 +70,7 @@ HELP: params
{ $notes "Instead of using this word, it is better to use " { $vocab-link "furnace.actions" } " and the associated validation machinery, which allows you to access values using " { $link "html.forms.values" } " words." } ; { $notes "Instead of using this word, it is better to use " { $vocab-link "furnace.actions" } " and the associated validation machinery, which allows you to access values using " { $link "html.forms.values" } " words." } ;
ARTICLE: "http.server.requests" "HTTP request variables" ARTICLE: "http.server.requests" "HTTP request variables"
"The following variables are set by the HTTP server at the beginning of a request." "The following variables are set by the HTTP server at the beginning of a request. Responder implementations may access these variables."
{ $subsections { $subsections
request request
url url
@ -87,21 +87,19 @@ ARTICLE: "http.server.requests" "HTTP request variables"
"Additional vocabularies may be set by vocabularies such as " { $vocab-link "html.forms" } " and " { $vocab-link "furnace.sessions" } "." ; "Additional vocabularies may be set by vocabularies such as " { $vocab-link "html.forms" } " and " { $vocab-link "furnace.sessions" } "." ;
ARTICLE: "http.server.responders" "HTTP server responders" ARTICLE: "http.server.responders" "HTTP server responders"
"Responders process requests and output " { $link "http.responses" } ". To implement a responder, define a new class and implement a method on the following generic word:"
{ $subsections call-responder* }
"The HTTP server dispatches requests to a main responder:" "The HTTP server dispatches requests to a main responder:"
{ $subsections main-responder } { $subsections main-responder }
"The main responder may in turn dispatch it a subordinate dispatcher, and so on." "The main responder may in turn dispatch it a subordinate dispatcher, and so on. To call a subordinate responder, use the following word:"
$nl
"Responders process requests and output " { $link "http.responses" } "; concretely are instances of classes which implement a generic word:"
{ $subsections call-responder* }
"To actually call a subordinate responder, use the following word instead:"
{ $subsections call-responder } { $subsections call-responder }
"A simple implementation of a responder which always outputs the same response:" "A simple implementation of a responder which always outputs the same response:"
{ $subsections { $subsections
trivial-responder trivial-responder
<trivial-responder> <trivial-responder>
} }
{ $vocab-subsection "Furnace actions" "furnace.actions" } "Writing new responders by hand is rarely necessary, because in most cases it is easier to use " { $vocab-link "furnace.actions" } " instead."
"In particular, writing new responders by hand is rarely necessary, because in most cases it is easier to use " { $vocab-link "furnace.actions" } " instead." ; { $vocab-subsection "Furnace actions" "furnace.actions" } ;
ARTICLE: "http.server.variables" "HTTP server variables" ARTICLE: "http.server.variables" "HTTP server variables"
"The following global variables control the behavior of the HTTP server. Both are off by default." "The following global variables control the behavior of the HTTP server. Both are off by default."