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

+ Add word space after `i.e.' and `e.g.'

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}