--- doc/homework/homework5.html	2001/10/01 20:13:38	1.10
+++ doc/homework/homework5.html	2002/05/03 18:34:20	1.14
@@ -236,6 +236,12 @@
 	    <b>&lt;window&gt;</b> the text in between is put in a
 	    popup javascript window
 	  </li>
+	  <li>
+	    <b>&lt;m&gt;</b> the inside text is LaTeX, and is
+	    converted to HTML (or MathML) on the fly, if the argument
+	    <i>eval</i> is set to "on" the intervening text will have
+	    a perl var expansion done to it before being converted.
+	  </li>
 	</ul>
       </li>
       <li>
@@ -288,7 +294,9 @@
 	  </li>
 	  <li>
 	    <b>&lt;randomlist&gt;</b> the enclosed tags are parsed in
-	    a stable random order
+	    a stable random order, optional argument <i>show</i>
+	    restricts the number of tags indie that are actually
+	    parsed the no more than <i>show</i>.
 	  </li>
 	  <li>
 	    <b>&lt;solved&gt;</b> everything inside the tag is
@@ -557,7 +565,7 @@
     </tr>
 
     <tr>
-             <td valign="top">map(seed;a,b,c,d;w,x,y,z)</td>
+             <td valign="top">/MAP(seed;w,x,y,z;a,b,c,d)</td>
              <td valign="top">Option 1 - &amp;map($seed,[\$w,\$x,\$y,\$z],[$a,$b,$c,$d]) or <br> 
                   Option 2 - &amp;map($seed,\@mappedArray,[$a,$b,$c,$d]) <br>
                   Option 3 - @mappedArray = &amp;map($seed,[$a,$b,$c,$d]) <br>
@@ -594,10 +602,14 @@
                         $w, $x, $y, and $z are variables</td>
              <td valign="top">The rmap functions does the reverse action of map if the same seed
                   is used in calling map and rmap. </td>
-             <td valign="top">In CAPA, the arguments are divided into three groups separated
-                  by a semicolon ;. In LON-CAPA, the separation is done by using [] brackets or
-                  using an array @a. Note the backslash (\) before the arguments in the
-                  second and third groups.</td>
+             <td valign="top">In CAPA, the arguments are divided into
+             three groups separated by a semicolon ;. In LON-CAPA, the
+             separation is done by using [] brackets (with create an
+             unamed vector reference) or using an array @a. Note the
+             backslash (\) before the arguments in the second and
+             third groups (Which cause Perl to send to variable
+             locations rather than the variable values, similar to a C
+             pointer).</td>
     </tr>
       
      <tr>
@@ -873,7 +885,7 @@
       </li>
       <li>
 	$external::part - set to the <i>id</i> of the current problem
-	&lt;part&gt;; zero if there are now &lt;part&gt;
+	&lt;part&gt;; zero if there are no &lt;part&gt;
       </li>
       <li>
 	$external::gradestatus - set to the value of the current
@@ -881,7 +893,7 @@
       </li>
       <li>
 	$external::datestatus - set to the current status of the clock
-	either CLOSED, CAN_ANSWER, CANNOT_ANSWER, or SHOW_ANSWER
+	either CLOSED, CAN_ANSWER, CANNOT_ANSWER, SHOW_ANSWER, or UNCHECKEDOUT
       </li>
       <li>
 	$external::randomseed - set to the number that was used to
@@ -891,12 +903,74 @@
       <li>$rad2deg - converts radians to degrees </li>
       <li>$deg2rad - converts degrees to radians </li>
     </ul>
-    
+
+    <h2> Form internals </h2>
+    <p> Form elements used for homework editing/response </p>
+    <p> the form is named lonhomework </p>
+    <h3> Viewing a problem (either CSTR or RES space)</h3>
+    <ul>
+      <li>
+	grade_target, grade_username, grade_domain, grade_symb - the
+	vaules take precedence over the the normal ENV settings of
+	these, use &Apache::lonxml::whichuser() to get back the
+	correct vaues of the items
+      </li>
+      <li>
+	HWVAL_response:number - the name of the input elements for each response. The response is the response's ID, and the :number part exists only for response with multiple foils, and is a unique number in order of the submission
+      </li>
+      <li>
+	changerandseed - the 'Change' button, only exists right after
+	the Change button is clicked
+      </li>
+      <li>
+	problemmode - in CSTR, it is either 'View','Edit','EditXML' or
+	'Analyze' depending on the desired view
+      </li>
+      <li>
+	rndseed - the currently requested random seed
+      </li>
+      <li>
+	showallfoils - if it exists, and we are in CSTR space, the
+	problem should ignore &lt;conceptgroup&gt; and the response's
+	max setting and show all possible foils
+      </li>
+      <li>
+	submit - the name of the Submit button
+      </li>
+      <li>
+	submitted - a hidden form parameter that can be used to tell
+	if the student has submitted answers or not, if it is set,
+	there should be answers to grade.
+      </li>
+    </ul>
+    <h3> Editing a problem (Edit mode)</h3>
+    <p> tagdepth referes to the current value of the xmlparsers tagdepth couter ($Apache::lonxml::currentdepth)</p>
+<p> Note: the file edit.pm has many helper functions for creating the standard elements for editing a tag and it's attributes, all of those functions follow these conventions </p>
+    <ul>
+      <li>
+	tagdepth_argname - I.E. 1_3.max, a parameter editing value,
+	max is the name of the parameter and it is for the third tag
+	inside the first tag
+      </li>
+      <li>
+	delete_tagdepth - if set to yes, delete tag tagdepth and all
+	tags inside of it
+      </li>
+      <li>
+	homework_edit_tagdepth - used by both &Apache::edit::editline
+	and &Apache::edit::editfield for the &lt;textarea&gt; and
+	&lt;input&gt; form elements they create
+      </li>
+      <li>
+	insert_tagdepth - used to request an tag insert, it is set to
+	the id number of the requested tag in the
+	%Apache::lonxml::insertlist
+    </ul>
     <hr>
     <address><a href="mailto:albertel@marvin.lite.msu.edu">Guy Albertelli</a></address>
 <!-- Created: Thu May 17 15:05:35 EDT 2001 -->
 <!-- hhmts start -->
-Last modified: Mon Oct  1 16:12:05 EDT 2001
+Last modified: Fri May  3 14:24:52 EDT 2002
 <!-- hhmts end -->
   </body>
 </html>