--- modules/damieng/clean_xml/loncapa.xsd	2015/04/27 18:05:31	1.2
+++ modules/damieng/clean_xml/loncapa.xsd	2015/04/27 20:39:01	1.3
@@ -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">