--- doc/homework/xml.html	2001/05/21 03:35:46	1.1
+++ doc/homework/xml.html	2002/05/03 18:34:20	1.3
@@ -20,37 +20,47 @@
     <h3>Global Variables</h3>
     <ul>
       <li>
-	<i>Apache::lonxml::debug</i> -
+	<i>$Apache::lonxml::debug</i> - debugging control
       </li>
       <li>
-	<i>Apache::lonxml::pwd</i> -
+	<i>@Apache::lonxml::pwd</i> - path to the directory containing the file currently being processed 
       </li>
       <li>
-	<i>Apache::lonxml::outputstack</i> -
+	<i>@Apache::lonxml::outputstack</i> <br />
+	<i>$Apache::lonxml::redirection</i> - these two are used for
+	capturing a subset of the output for later processing, don't
+	touch them directly use &startredirection and &endredirection
       </li>
       <li>
-	<i>Apache::lonxml::redirection</i> -
+	<i>$Apache::lonxml::import</i> - controls whether the
+	&lt;import&gt; tag actually does anything
       </li>
       <li>
-	<i>Apache::lonxml::import</i> -
+	<i>@Apache::lonxml::extlinks</i> - a list of URLs that the
+	user is allowed to look at because of the current resource
+	(images, and links)
       </li>
       <li>
-	<i>Apache::lonxml::extlinks</i> -
+	<i>#Apache::lonxml::metamode</i> - some output is turned off,
+	the meta target wants a specific subset, use &lt;output&gt; to
+	guarentee that the catianed data will be in the parsing output
       </li>
       <li>
-	<i>Apache::lonxml::metamode</i> -
+	<i>#Apache::lonxml::evaluate</i> - controls whether
+	run::evaluate actually derefences variable references
       </li>
       <li>
-	<i>Apache::lonxml::evaluate</i> -
+	<i>%Apache::lonxml::insertlist</i> - data structure for edit
+	mode, determines what tags can go into what other tags
       </li>
       <li>
-	<i>Apache::lonxml::insertlist</i> -
+	<i>@Apache::lonxml::namespace</i> - stores the list of tag
+	namespaces used in the insertlist.tab file that are currently
+	active, used only in edit mode.
       </li>
       <li>
-	<i>Apache::lonxml::namespace</i> -
-      </li>
-      <li>
-	<i>Apache::lonxml::</i> -
+	<i>$Apache::lonxml::registered</i> - set to 1 once the remote
+	has been updated to know what resource we are looking at.
       </li>
     </ul>
 	
@@ -85,6 +95,12 @@
 	%Apache::lonxml::insertlist structure of what tags can have
 	what other tags inside.
       </li>
+      <li>
+	<i>whichuser</i> - returns a list of $symb, $courseid,
+	$domain, $name that is correct for calls to lonnet functions
+	for this setup. Uses form.grade_ parameters, if the user is
+	allowed to mgr in the course
+      </li>
     </ul>
     <h3>Functions Tag Handlers can use</h3>
     <p>
@@ -178,24 +194,29 @@ sub BEGIN {
     <h3>Style File specific tags</h3>
     <ul>
       <li>
-	<b>&lt;definetag&gt;</b> - 
+	<b>&lt;definetag&gt;</b> - 2 arguments, <i>name</i> name of
+	new tag being defined, if proceeded with a / defining an end
+	tag, required; <i>parms</i> parameters of the new tag, the
+	value of these parameters can be accesed by $parametername.
       </li>
       <li>
-	<b>&lt;render&gt;</b> - 
+	<b>&lt;render&gt;</b> - define what the new tag does for a non meta target
       </li>
       <li>
-	<b>&lt;meta&gt;</b> - 
+	<b>&lt;meta&gt;</b> - define what the new tag does for a meta target
       </li>
       <li>
-	<b>&lt;tex&gt; / &lt;web&gt; / &lt;latexsource&gt;</b> - 
+	<b>&lt;tex&gt; / &lt;web&gt; / &lt;latexsource&gt;</b> -
+	define what a new tag does for a specific no meta target, all
+	data inside a &lt;render&gt; is render to all targets except
+	when surrounded by a specific target tags.
       </li>
     </ul>
-
     <hr>
     <address><a href="mailto:albertel@marvin.lite.msu.edu">Guy Albertelli</a></address>
 <!-- Created: Sun May 20 15:47:08 EDT 2001 -->
 <!-- hhmts start -->
-Last modified: Sun May 20 23:34:57 EDT 2001
+Last modified: Fri May  3 14:26:22 EDT 2002
 <!-- hhmts end -->
   </body>
 </html>