--- modules/damieng/clean_xml/loncapa.xsd	2015/05/01 20:32:24	1.7
+++ modules/damieng/clean_xml/loncapa.xsd	2015/05/06 20:20:25	1.10
@@ -1057,7 +1057,9 @@
   <xs:element name="imageresponse">
     <xs:annotation>
       <xs:documentation>
-        Query for the selection of an image in a list.
+        Query for positions on images.
+        
+        Each foil must contain a reference to an image, at least one rectangle or polygon specifying the correct region, and a text describing what should be selected. Students have to click on the foil image, and their answer is correct if they clicked inside the correct region.
       </xs:documentation>
     </xs:annotation>
     <xs:complexType mixed="true">
@@ -2124,6 +2126,17 @@
       </xs:choice>
       <xs:attributeGroup ref="response-identification"/>
       <xs:attribute default="autoez" name="options">
+        <xs:annotation>
+          <xs:documentation>
+            Comma-separated list of options:
+            
+            - autoez: Auto E,Z stereochemistry
+            - multipart: Multipart Structures
+            - nostereo: No stereochemistry
+            - reaction: Is a reaction
+            - number: Able to number atoms
+          </xs:documentation>
+        </xs:annotation>
         <xs:simpleType>
           <xs:union memberTypes="perl">
             <xs:simpleType>
@@ -2137,14 +2150,16 @@
       <xs:attribute name="molecule" type="xs:string">
         <xs:annotation>
           <xs:documentation>
-            Starting Molecule
+            Starting Molecule.
+            Syntax: JME.
           </xs:documentation>
         </xs:annotation>
       </xs:attribute>
       <xs:attribute name="answer" type="xs:string">
         <xs:annotation>
           <xs:documentation>
-            Correct Answer
+            Correct Answer.
+            Syntax: SMILES (Simplified Molecular Input Line Entry System).
           </xs:documentation>
         </xs:annotation>
       </xs:attribute>
@@ -2274,6 +2289,7 @@
     </xs:annotation>
     <xs:complexType mixed="true">
       <xs:choice maxOccurs="unbounded" minOccurs="0">
+        <xs:element ref="responseparam"/>
         <xs:element ref="textfield"/>
         <xs:element ref="hiddensubmission"/>
         <xs:element ref="hiddenline"/>
@@ -2401,7 +2417,8 @@
       <xs:attribute name="spellcheck">
         <xs:annotation>
           <xs:documentation>
-            Spellcheck for
+            If this attribute is present, the text the user types is spellchecked when focus leaves the input field.
+            The value specifies the language in which the spellcheck is performed.
           </xs:documentation>
         </xs:annotation>
         <xs:simpleType>
@@ -2447,6 +2464,12 @@
       </xs:attribute>
       <xs:attribute default="no" name="readonly" type="yesno-or-perl"/>
       <xs:attribute name="spellcheck">
+        <xs:annotation>
+          <xs:documentation>
+            If this attribute is present, the text the user types is spellchecked when focus leaves the input field.
+            The value specifies the language in which the spellcheck is performed.
+          </xs:documentation>
+        </xs:annotation>
         <xs:simpleType>
           <xs:union memberTypes="perl">
             <xs:simpleType>
@@ -6553,14 +6576,60 @@
         <xs:group ref="inlines"/>
       </xs:choice>
       <xs:attributeGroup ref="coreattrs"/>
-      <xs:attribute name="name" type="xs:string"/>
-      <xs:attribute name="href" type="xs:anyURI"/>
-      <xs:attribute name="target" type="xs:string"/>
-      <xs:attribute name="title" type="xs:string"/>
-      <xs:attribute name="uriprint" type="xs:string"/>
-      <xs:attribute name="anchorprint" type="xs:string"/>
-      <xs:attribute name="rel" type="xs:NMTOKENS"/>
+      <xs:attribute name="name" type="xs:string">
+        <xs:annotation>
+          <xs:documentation>
+            HTML 4 only, Obsolete since HTML5.
+            
+            This attribute is required in an anchor defining a target location within a page. A value for name is similar to a value for the id core attribute and should be an alphanumeric identifier unique to the document. Under the HTML 4.01 specification, id and name both can be used with the &lt;a&gt; element as long as they have identical values.
+            
+            Usage note: This attribute is obsolete in HTML5, use global attribute id instead.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+      <xs:attribute name="href" type="xs:anyURI">
+        <xs:annotation>
+          <xs:documentation>
+            This was the single required attribute for anchors defining a hypertext source link, but is no longer required in HTML5. Omitting this attribute creates a placeholder link. The href attribute indicates the link target, either a URL or a URL fragment. A URL fragment is a name preceded by a hash mark (#), which specifies an internal target location (an ID) within the current document. URLs are not restricted to Web (HTTP)-based documents. URLs might use any protocol supported by the browser. For example, file, ftp, and mailto work in most user agents.
+            
+            Note: You can use the special fragment "top" to create a link back to the top of the page; for example &lt;a href="#top"&gt;Return to top&lt;/a&gt;. This behavior is specified by HTML5.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+      <xs:attribute name="target" type="xs:string">
+        <xs:annotation>
+          <xs:documentation>
+            This attribute specifies where to display the linked resource. In HTML4, this is the name of, or a keyword for, a frame. In HTML5, it is a name of, or keyword for, a browsing context (for example, tab, window, or inline frame). The following keywords have special meanings:
+            
+            * _self: Load the response into the same HTML4 frame (or HTML5 browsing context) as the current one. This value is the default if the attribute is not specified.
+            * _blank: Load the response into a new unnamed HTML4 window or HTML5 browsing context.
+            * _parent: Load the response into the HTML4 frameset parent of the current frame or HTML5 parent browsing context of the current one. If there is no parent, this option behaves the same way as _self.
+            * _top: In HTML4: Load the response into the full, original window, canceling all other frames. In HTML5: Load the response into the top-level browsing context (that is, the browsing context that is an ancestor of the current one, and has no parent). If there is no parent, this option behaves the same way as _self.
+            
+            Use this attribute only if the href attribute is present.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+      <xs:attribute name="title" type="xs:string">
+        <xs:annotation>
+          <xs:documentation>
+            Contains a text representing advisory information related to the element it belongs to. Such information can typically, but not necessarily, be presented to the user as a tooltip.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+      <xs:attribute name="rel" type="xs:NMTOKENS">
+        <xs:annotation>
+          <xs:documentation>
+            For anchors containing the href attribute, this attribute specifies the relationship of the target object to the link object. The value is a comma-separated list of link types values. The values and their semantics will be registered by some authority that might have meaning to the document author. The default relationship, if no other is given, is void. Use this attribute only if the href attribute is present.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
       <xs:attribute name="accesskey">
+        <xs:annotation>
+          <xs:documentation>
+            Provides a hint for generating a keyboard shortcut for the current element. This attribute consists of a space-separated list of characters. The browser should use the first one that exists on the computer keyboard layout.
+          </xs:documentation>
+        </xs:annotation>
         <xs:simpleType>
           <xs:restriction base="xs:string">
             <xs:length fixed="true" value="1"/>
@@ -6578,6 +6647,38 @@
           </xs:documentation>
         </xs:annotation>
       </xs:attribute>
+      <xs:attribute name="uriprint" type="xs:string">
+        <xs:annotation>
+          <xs:documentation>
+            Attribute specific to LON-CAPA.
+            Display the href attribute when printing.
+          </xs:documentation>
+        </xs:annotation>
+        <xs:simpleType>
+          <xs:restriction base="xs:string">
+            <xs:enumeration value="on"/>
+            <xs:enumeration value="uriprint"/>
+            <xs:enumeration value="yes"/>
+            <xs:enumeration value="1"/>
+          </xs:restriction>
+        </xs:simpleType>
+      </xs:attribute>
+      <xs:attribute name="anchorprint" type="xs:string">
+        <xs:annotation>
+          <xs:documentation>
+            Attribute specific to LON-CAPA.
+            Display the name attribute when printing.
+          </xs:documentation>
+        </xs:annotation>
+        <xs:simpleType>
+          <xs:restriction base="xs:string">
+            <xs:enumeration value="on"/>
+            <xs:enumeration value="anchorprint"/>
+            <xs:enumeration value="yes"/>
+            <xs:enumeration value="1"/>
+          </xs:restriction>
+        </xs:simpleType>
+      </xs:attribute>
     </xs:complexType>
   </xs:element>
   <xs:element name="em" type="inlineBaseType">