diff --git a/scheme/httpd/surflets/latex/surflet.tex b/scheme/httpd/surflets/latex/surflet.tex index b354e37..b39b545 100644 --- a/scheme/httpd/surflets/latex/surflet.tex +++ b/scheme/httpd/surflets/latex/surflet.tex @@ -59,7 +59,7 @@ See the examples for further informations. computation, calls \semvar{response-maker} with an argument and lets the server send it to the client. \semvar{response-maker} is a procedure getting one argument, the ``continuation address'' and - yielding a valid response---\ie an \ex{httpd} \ex{response} + yielding a valid response---\ie{} an \ex{httpd} \ex{response} object. See the manual of the \ex{httpd} for details about generating such an object. If you use SXML, you won't need the details, though. If the browser sends a request to the @@ -69,19 +69,19 @@ See the examples for further informations. looks this way from the servlet's point of view. \ex{send/finish} returns the \semvar{response} to the server and - finishes the computation of the servlet---\ie the instance of the + finishes the computation of the servlet---\ie{} the instance of the servlet will not accept any more requests. \semvar{response} must be a valid \ex{httpd} \ex{response} object. \ex{send} returns the \semvar{response} to the server. It does not finish the computation of the servlet, although it does not - return---\ie the instance of the servlet may accept future + return---\ie{} the instance of the servlet may accept future requests. Usually, you won't need this procedure. The \ex{send-html...} procedures do the same as their counterparts sans \ex{-html}, except that the expect SXML objects rather than response objects. SXML objects are lists that describe an HTML - page---\eg + page---\eg{} \begin{alltt} `(html (title "My Homepage") (body (h1 "Welcome to my homepage!") @@ -95,7 +95,7 @@ See the examples for further informations. \begin{desc} \ex{form-query} does the same as \ex{cgi-form-query}: It parses the \semvar{string} that may be the search part of a \ex{GET} request - line into an association list of bindings---\eg + line into an association list of bindings---\eg{} \begin{alltt} (form-query "button=on&select=13") ==> '(("button" . "on") ("select" . "13")) @@ -120,7 +120,7 @@ See the examples for further informations. values of the \semvar{name} in \semvar{bindings}. \ex{extract-single-binding} returns the value of \semvar{name} in \semvar{bindings}. If there are more than one or zero \semvar{name}s - in \semvar{bindings}, an error is signalled. \Eg + in \semvar{bindings}, an error is signalled. \Eg{} \begin{alltt} (extract-bindings (form-query "button=on&select=13") "select") @@ -147,7 +147,7 @@ See the examples for further informations. \ex{make-input-field} creates an input field for a web form. \semvar{SXML} is an SXML-reprentation of the input-field. \semvar{transformer} gets the value of the input field - as a string and returns the scheme value of the input field. \Eg you + as a string and returns the scheme value of the input field. \Eg{} you can do a string to number conversion with this (see \ex{make-number-input-field below}). \semvar{name} Is used to acces the value of the input field out of a request---it should be @@ -168,13 +168,13 @@ See the examples for further informations. \defunx{make-password-input-field}{\ovar{attributes}}{input-field} \defunx{make-number-input-field}{\ovar{default \ovar{attributes}}}{input-field} \defunx{make-textarea-input-field}{\ovar{default-text \ovar{attributes}}}{input-field} -\defunx{make-select-input-field}{options \ovar{attributes}}{input-field} +\defunx{make-select-input-field}{options \ovar{multiple? \ovar{attributes}}}{input-field} \defunx{make-checkbox-input-field}{\ovar{value \ovar{attributes}}}{input-field} \defunx{make-radio-input-fields}{values \ovar{attributes}}{input-fields} \begin{desc} These functions generate various kind of \semvar{input-field}s. The \semvar{attributes} argument contains a list of attributes in SXML - notation---\eg \ex{'(@ (id 13))}. It is appended to the attributes + notation---\eg{} \ex{'(@ (id 13))}. It is appended to the attributes of the input field that are generated by the functions. \ex{make-text-input-field} creates a text input field, optionally @@ -190,21 +190,21 @@ See the examples for further informations. field, optionally filled out with \semvar{default-text}. You may want to give the \ex{cols} and \ex{rows} attributes explicitly. \ex{make-select-input-field} creates a select input - field that is either displayed as scrollable list (the \ex{size} - attribute is not given or greater than 1) or a drop down list (the - \ex{size} attribute is equal to 1). The items of the list is given - in \semvar{options} and the result of the select input field is a - list of all selected items in \semvar{options}.\FIXME{let select - input fields really return a list of values in - servlets.scm}\ex{make-checkbox-input-field} creats a checkbox input - field, optional with a value of \semvar{value}. If \semvar{value} is - not given, the browser usually returns - ``on''. \ex{make-radio-input-fields} is somewhat special as it - returns a \emph{list} of radio button input fields. The reason is - that radio input fields must have the same name, but the text that - surrounds the radio input fields is not included in the definition - of the input field. \Ie you must split the resulting list up into - its parts and distribute them among your HTML text. The value of the + field of the items given in \semvar{options}. Depending on a given + \ex{size} attribute the select input field will be displayed as a + scrollable list or a dropdown list (see a reference to HTML for + details). If \semvar{multiple?} is true, the select input field will + allow multiple selections. In this case, \ex{input-field-value} will + return a (possibly empty) list of all selected items. Otherwise, the + selected string is returned. \ex{make-checkbox-input-field} creats + a checkbox input field, optional with a value of \semvar{value}. If + \semvar{value} is not given, the browser usually returns ``on''. + \ex{make-radio-input-fields} is somewhat special as it returns a + \emph{list} of radio button input fields. The reason is that radio + input fields must have the same name, but the text that surrounds + the radio input fields is not included in the definition of the + input field. \Ie{} you must split the resulting list up into its parts + and distribute them among your HTML text. The value of the \textit{n}th radio input field is the \textit{n}th element of \semvar{values}. \end{desc} @@ -221,7 +221,7 @@ See the examples for further informations. choose a default value like ``Submit''. \ex{make-reset-button} creates a reset button that clears all entry fields of the form. If you omit the \semvar{cpation}, the browser will choose a default - value for the caption of the button---\eg ``Reset''---otherwise + value for the caption of the button---\eg{} ``Reset''---otherwise \semvar{caption}. \ex{make-image-button} creates an image button using the image located at \semvar{source}. \end{desc}