--- loncom/html/adm/help/tex/Authoring_ExternalResponse.tex	2005/02/22 14:57:21	1.2
+++ loncom/html/adm/help/tex/Authoring_ExternalResponse.tex	2007/09/11 19:21:57	1.3
@@ -9,18 +9,30 @@ the tag. Possible attributes are:
 \begin{itemize}
 \item \textbf{url}\index{url}: url to submit the answer form to. It does
 not need to be a LON-CAPA machine.
-\item \textbf{answer}\index{answer}:  string or scalar variable that can
-encode something that should encode the correct answer. In some cases,
-this may be nothing. 
+\item \textbf{answer}\index{answer}: data to post in the form element 
+\texttt{LONCAPA\_correct\_answer} to the remote site.
 \item \textbf{form}\index{form}: hash variable name that will be submitted
 to the remote site as a HTTP form.
 \end{itemize}
+
+The form sent will consist of
+\begin{itemize}
+\item \textbf{LONCAPA\_student\_response} full text of
+what the student entered in the entry field
+\item \textbf{LONCAPA\_correct\_answer} contents of the answer
+attribute
+\item \textbf{LONCAPA\_language} specified language encoding
+of the requesting resource
+\item \textbf{all items in the form attribute} if any of these clash with the
+above, the above values will overwite the value in the form attribute
+\end{itemize}
+
 The response of the remote server needs to be in XML as follows: 
 
 \begin{itemize}
 \item \textbf{loncapagrade}\index{loncapagrade}: takes no attributes, but
 must surround the response.
-\item \textbf{awardetail}\index{awardetail}: required. The delimited text
+\item \textbf{awarddetail}\index{awarddetail}: required. The delimited text
 inside must be one of the detailed results that appears in the data
 storage documentation. CVS:loncapa/doc/homework/datastorage, look
 for \textbf{resource.partid.responseid.awarddetail}.
@@ -28,7 +40,7 @@ for \textbf{resource.partid.responseid.a
 the student.
 \end{itemize}
 Example: \begin{verbatim} <loncapagrade>
-    <awardetail>INCORRECT</awardetail>
+    <awarddetail>INCORRECT</awarddetail>
     <message>
 A message to be shown to the students
     </message>