diff --git a/collects/web-server/scribblings/cache-table.scrbl b/collects/web-server/scribblings/cache-table.scrbl index 6c6512c7b5..e798dfa645 100644 --- a/collects/web-server/scribblings/cache-table.scrbl +++ b/collects/web-server/scribblings/cache-table.scrbl @@ -6,7 +6,7 @@ @defmodule[web-server/private/cache-table]{ -@filepath{private/cache-table.ss} provides a set of caching hash table +This module provides a set of caching hash table functions. @defproc[(make-cache-table) diff --git a/collects/web-server/scribblings/connection-manager.scrbl b/collects/web-server/scribblings/connection-manager.scrbl index 83dceed0f2..434b4db8b4 100644 --- a/collects/web-server/scribblings/connection-manager.scrbl +++ b/collects/web-server/scribblings/connection-manager.scrbl @@ -7,7 +7,7 @@ @defmodule[web-server/private/connection-manager]{ -@filepath{private/connection-manager.ss} provides functionality for managing pairs of +This module provides functionality for managing pairs of input and output ports. We have plans to allow a number of different strategies for doing this. diff --git a/collects/web-server/scribblings/contracts.scrbl b/collects/web-server/scribblings/contracts.scrbl index 5a4174860b..a4fed490a8 100644 --- a/collects/web-server/scribblings/contracts.scrbl +++ b/collects/web-server/scribblings/contracts.scrbl @@ -7,7 +7,7 @@ @defmodule[web-server/servlet/servlet-structs]{ -@filepath{servlet/servlet-structs.ss} provides a number of contracts +This module provides a number of contracts for use in servlets. @defthing[k-url? contract?]{ diff --git a/collects/web-server/scribblings/ctable-structs.scrbl b/collects/web-server/scribblings/ctable-structs.scrbl index c796b293e6..d9f97ebe50 100644 --- a/collects/web-server/scribblings/ctable-structs.scrbl +++ b/collects/web-server/scribblings/ctable-structs.scrbl @@ -9,7 +9,7 @@ @defmodule[web-server/configuration/configuration-table-structs]{ -@filepath{configuration/configuration-table-structs.ss} provides the following structures that +This module provides the following structures that represent a standard configuration (see @secref["web-server-unit.ss"]) of the @web-server . The contracts on this structure influence the valid types of values in the configuration table S-expression file format described in diff --git a/collects/web-server/scribblings/ctable.scrbl b/collects/web-server/scribblings/ctable.scrbl index 162560a514..0366511a90 100644 --- a/collects/web-server/scribblings/ctable.scrbl +++ b/collects/web-server/scribblings/ctable.scrbl @@ -8,7 +8,7 @@ @defmodule[web-server/configuration/configuration-table]{ -@filepath{configuration/configuration-table.ss} provides functions for +This module provides functions for reading, writing, parsing, and printing @scheme[configuration-table] structures. diff --git a/collects/web-server/scribblings/dispatchers.scrbl b/collects/web-server/scribblings/dispatchers.scrbl index 9f323f00c3..574ebab182 100644 --- a/collects/web-server/scribblings/dispatchers.scrbl +++ b/collects/web-server/scribblings/dispatchers.scrbl @@ -27,7 +27,7 @@ documentation. @defmodule[web-server/dispatchers/dispatch]{ -@filepath{dispatchers/dispatch.ss} provides a few functions for dispatchers in general. +This module provides a few functions for dispatchers in general. @defthing[dispatcher/c contract?]{ Equivalent to @scheme[(connection? request? . -> . void)]. @@ -74,7 +74,7 @@ Consider the following example dispatcher, that captures the essence of URL rewr @defmodule[web-server/dispatchers/filesystem-map]{ -@filepath{dispatchers/filesystem-map.ss} provides a means of mapping +This module provides a means of mapping URLs to paths on the filesystem. @defthing[url->path/c contract?]{ diff --git a/collects/web-server/scribblings/file-box.scrbl b/collects/web-server/scribblings/file-box.scrbl index 10e1060936..31fe9747c4 100644 --- a/collects/web-server/scribblings/file-box.scrbl +++ b/collects/web-server/scribblings/file-box.scrbl @@ -9,7 +9,7 @@ As mentioned earlier, it is dangerous to rely on the store in Web Language servlets, due to the deployment scenarios available -to them. @filepath{lang/file-box.ss} provides a simple API to replace +to them. This module provides a simple API to replace boxes in a safe way. @defproc[(file-box? [v any/c]) diff --git a/collects/web-server/scribblings/managers.scrbl b/collects/web-server/scribblings/managers.scrbl index 645e017ae9..d7e8eaa0aa 100644 --- a/collects/web-server/scribblings/managers.scrbl +++ b/collects/web-server/scribblings/managers.scrbl @@ -17,7 +17,7 @@ pluggable through the manager interface. @defmodule[web-server/managers/manager]{ -@filepath{managers/manager.ss} defines the manager interface. It is required by +This module defines the manager interface. It is required by the users and implementers of managers. @defstruct[manager ([create-instance ((-> void) . -> . number?)] @@ -65,7 +65,7 @@ the users and implementers of managers. @defmodule[web-server/managers/none]{ -@filepath{managers/none.ss} defines a manager constructor: +This module defines a manager constructor: @defproc[(create-none-manager (instance-expiration-handler expiration-handler/c)) manager?]{ @@ -90,7 +90,7 @@ Web Language. (See @secref["stateless"].) @defmodule[web-server/managers/timeouts]{ -@filepath{managers/timeouts.ss} defines a manager constructor: +This module defines a manager constructor: @defproc[(create-timeout-manager [instance-exp-handler expiration-handler/c] [instance-timeout number?] @@ -122,7 +122,7 @@ deployments of the @web-server . @defmodule[web-server/managers/lru]{ -@filepath{managers/lru.ss} defines a manager constructor: +This module defines a manager constructor: @defproc[(create-LRU-manager [instance-expiration-handler expiration-handler/c] diff --git a/collects/web-server/scribblings/mime-types.scrbl b/collects/web-server/scribblings/mime-types.scrbl index c911b77412..f7325b8aab 100644 --- a/collects/web-server/scribblings/mime-types.scrbl +++ b/collects/web-server/scribblings/mime-types.scrbl @@ -6,7 +6,7 @@ @defmodule[web-server/private/mime-types]{ -@filepath{private/mime-types.ss} provides function for dealing with @filepath{mime.types} +This module provides function for dealing with @filepath{mime.types} files. @defproc[(read-mime-types [p path-string?]) diff --git a/collects/web-server/scribblings/mod-map.scrbl b/collects/web-server/scribblings/mod-map.scrbl index 7e7fcc1bfc..3306450f0f 100644 --- a/collects/web-server/scribblings/mod-map.scrbl +++ b/collects/web-server/scribblings/mod-map.scrbl @@ -7,7 +7,7 @@ @defmodule[web-server/private/mod-map]{ The @schememodname[scheme/serialize] library provides the -functionality of serializing values. @filepath{private/mod-map.ss} +functionality of serializing values. This module compresses the serialized representation. @defproc[(compress-serial [sv list?]) diff --git a/collects/web-server/scribblings/namespace.scrbl b/collects/web-server/scribblings/namespace.scrbl index f49d1f67e3..bfe4b6fc8e 100644 --- a/collects/web-server/scribblings/namespace.scrbl +++ b/collects/web-server/scribblings/namespace.scrbl @@ -6,9 +6,9 @@ @defmodule[web-server/configuration/namespace]{ -@filepath{configuration/namespace.ss} provides a function to help create the -@scheme[make-servlet-namespace] procedure needed by the @scheme[make] functions -of @filepath{dispatchers/dispatch-servlets.ss} and @filepath{dispatchers/dispatch-lang.ss}. +This module provides a function to help create the +@scheme[make-servlet-namespace] procedure needed by the @scheme[make] function +of @schememodname[web-server/dispatchers/dispatch-servlets]. @defthing[make-servlet-namespace/c contract?]{ Equivalent to diff --git a/collects/web-server/scribblings/responders.scrbl b/collects/web-server/scribblings/responders.scrbl index 27d35c5622..03cb9d7226 100644 --- a/collects/web-server/scribblings/responders.scrbl +++ b/collects/web-server/scribblings/responders.scrbl @@ -8,7 +8,7 @@ @defmodule[web-server/configuration/responders]{ -@filepath{configuration/responders.ss} provides some functions that help constructing HTTP responders. +This module provides some functions that help constructing HTTP responders. These functions are used by the default dispatcher constructor (see @secref["web-server-unit.ss"]) to turn the paths given in the @scheme[configuration-table] into responders for the associated circumstance. diff --git a/collects/web-server/scribblings/stateless-usage.scrbl b/collects/web-server/scribblings/stateless-usage.scrbl index 2ba76f61ff..3ae1a7ea6b 100644 --- a/collects/web-server/scribblings/stateless-usage.scrbl +++ b/collects/web-server/scribblings/stateless-usage.scrbl @@ -6,19 +6,17 @@ A servlet has the following process performed on it automatically: @itemize[ @item{All uses of @scheme[letrec] are removed and replaced with equivalent uses of - @scheme[let] and imperative features. (@filepath{lang/elim-letrec.ss})} + @scheme[let] and imperative features.} @item{The program is converted into ANF (Administrative Normal Form), - making all continuations explicit. (@filepath{lang/anormal.ss})} + making all continuations explicit.} @item{All continuations (and other continuations marks) are recorded in the continuation marks of the expression - they are the continuation of. (@filepath{lang/elim-callcc.ss})} - @item{All calls to external modules are identified and marked. - (@filepath{lang/elim-callcc.ss})} + they are the continuation of.} + @item{All calls to external modules are identified and marked.} @item{All uses of @scheme[call/cc] are removed and replaced with - equivalent gathering of the continuations through the continuation-marks. - (@filepath{lang/elim-callcc.ss})} + equivalent gathering of the continuations through the continuation-marks.} @item{The program is defunctionalized with a serializable data-structure for each - anonymous lambda. (@filepath{lang/defun.ss})} + anonymous lambda.} ] This process allows the continuations captured by your servlet to be serialized. diff --git a/collects/web-server/scribblings/timer.scrbl b/collects/web-server/scribblings/timer.scrbl index 9532a4c384..098b0fe38d 100644 --- a/collects/web-server/scribblings/timer.scrbl +++ b/collects/web-server/scribblings/timer.scrbl @@ -6,7 +6,7 @@ @defmodule[web-server/private/timer]{ -@filepath{private/timer.ss} provides a functionality for running +This module provides a functionality for running procedures after a given amount of time, that may be extended. @defstruct[timer ([evt evt?] diff --git a/collects/web-server/scribblings/url-param.scrbl b/collects/web-server/scribblings/url-param.scrbl index 4e2a7279c9..e1fd11094d 100644 --- a/collects/web-server/scribblings/url-param.scrbl +++ b/collects/web-server/scribblings/url-param.scrbl @@ -10,7 +10,7 @@ The @web-server needs to encode information in URLs. If this data is stored in the query string, than it will be overridden by browsers that make GET requests to those URLs with more query data. So, it must be encoded -in URL params. @filepath{private/url-param.ss} provides functions for helping +in URL params. This module provides functions for helping with this process. @defproc[(insert-param [u url?] diff --git a/collects/web-server/scribblings/util.scrbl b/collects/web-server/scribblings/util.scrbl index 58a748d839..c71446be23 100644 --- a/collects/web-server/scribblings/util.scrbl +++ b/collects/web-server/scribblings/util.scrbl @@ -10,7 +10,7 @@ @defmodule[web-server/private/util] There are a number of other miscellaneous utilities the @web-server -needs. They are provided by @filepath{private/util.ss}. +needs. They are provided by this module. @section{Contracts} @defthing[non-empty-string/c contract?]{Contract for non-empty strings.} diff --git a/collects/web-server/scribblings/web-param.scrbl b/collects/web-server/scribblings/web-param.scrbl index e6365d82f5..ab0639d790 100644 --- a/collects/web-server/scribblings/web-param.scrbl +++ b/collects/web-server/scribblings/web-param.scrbl @@ -7,7 +7,7 @@ @defmodule[web-server/lang/web-param]{ It is not easy to use @scheme[parameterize] in the -Web Language. @filepath{lang/web-param.ss} provides (roughly) the same +Web Language. This module provides (roughly) the same functionality in a way that is serializable. Like other serializable things in the Web Language, they are sensitive to source code modification.