scsh-conservatory
/
sunet
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

+ Interface to MAKE-SELECT-INPUT-FIELD has changed 

+ Add word space after `i.e.' and `e.g.'
This commit is contained in:
interp 2002-10-04 14:07:46 +00:00
parent 85b0d91475
commit a6b499426a
1 changed files with 25 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
scheme/httpd/surflets/latex/surflet.tex
View File

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