--- doc/homework/homework5.html	2001/12/07 15:05:03	1.12
+++ doc/homework/homework5.html	2002/05/03 18:34:20	1.14
@@ -294,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
@@ -883,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
@@ -891,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
@@ -901,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: Fri Dec  7 10:03:55 EST 2001
+Last modified: Fri May  3 14:24:52 EDT 2002
 <!-- hhmts end -->
   </body>
 </html>