--- modules/damieng/clean_xml/loncapa.xsd	2015/04/27 18:05:31	1.2
+++ modules/damieng/clean_xml/loncapa.xsd	2015/04/29 15:31:27	1.4
@@ -734,14 +734,14 @@
     <xs:attribute name="checkboxvalue" type="xs:string">
       <xs:annotation>
         <xs:documentation>
-          Two-option checkboxes for
+          When there are only 2 option values, set this attribute to one of them in order to display checkboxes. A foil checkbox will have to be checked when the foil has the chosen option value.
         </xs:documentation>
       </xs:annotation>
     </xs:attribute>
     <xs:attribute name="checkboxoptions">
       <xs:annotation>
         <xs:documentation>
-          Checkbox options
+          Set to "nochoice" to avoid the display of the list of option values.
         </xs:documentation>
       </xs:annotation>
       <xs:simpleType>
@@ -791,7 +791,11 @@
   </xs:complexType>
   <xs:complexType name="optionresponse--drawoptionlist">
     <xs:annotation>
-      <xs:documentation>Draw Option List</xs:documentation>
+      <xs:documentation>
+        Draw Option List
+        
+        By default, the list of options is presented in front of the foils. Using the optional &lt;drawoptionlist&gt; element, the list of options can be embedded into a foil.
+      </xs:documentation>
     </xs:annotation>
   </xs:complexType>
   
@@ -804,6 +808,7 @@
     <xs:annotation>
       <xs:documentation>
         Query for matches betweens items from two lists.
+        It is also possible to query for matches with optionresponse, but optionresponse only accepts simple text for the matches. With matchresponse, it is possible to use anything as a match, such as equations, images, plots, or long styled texts.
       </xs:documentation>
     </xs:annotation>
     <xs:complexType mixed="true">