--- modules/damieng/clean_xml/loncapa.xsd	2015/08/12 14:58:57	1.17
+++ modules/damieng/clean_xml/loncapa.xsd	2015/12/23 19:38:13	1.18
@@ -1,7 +1,17 @@
-<?xml version="1.0" encoding="UTF-8"?><xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xml:lang="en">
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  This schema was created for LON-CAPA.
+  Element documentation often comes from the Mozilla Developer Network.
+  MDN wiki documents are created by Mozilla Contributors and licensed under CC-BY-SA 2.5.
+  Links:
+      https://developer.mozilla.org/en-US/docs/Web/HTML/Element
+      https://developer.mozilla.org/en-US/docs/MDN/About$history
+      http://creativecommons.org/licenses/by-sa/2.5/
+-->
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xml:lang="en">
   <xs:annotation>
     <xs:documentation>
-      XML schema for LON-CAPA 2 documents.
+      XML schema for LON-CAPA documents.
     </xs:documentation>
   </xs:annotation>
   
@@ -229,7 +239,6 @@
       <xs:element ref="standalone"/>
       <xs:element ref="script"/>
       <xs:element ref="languageblock"/>
-      <xs:element ref="translated"/>
       <xs:element ref="window"/>
       <xs:element ref="windowlink"/>
       <xs:element ref="togglebox"/>
@@ -326,6 +335,7 @@
       <xs:element ref="textline"/>
       <xs:element ref="displayweight"/>
       <xs:element ref="displaystudentphoto"/>
+      <xs:element ref="translated"/>
       
       <xs:element ref="span"/>
       <xs:element ref="a"/>
@@ -5485,13 +5495,7 @@
       <xs:choice maxOccurs="unbounded" minOccurs="0">
         <xs:element ref="script"/>
         <xs:element ref="style"/>
-        <xs:element name="meta" type="htmlMeta">
-          <xs:annotation>
-            <xs:documentation>
-              generic metainformation
-            </xs:documentation>
-          </xs:annotation>
-        </xs:element>
+        <xs:element name="meta" type="htmlMeta"/>
         <xs:element ref="link"/>
         <xs:element ref="import"/>
       </xs:choice>
@@ -5552,7 +5556,7 @@
   <xs:element name="base">
     <xs:annotation>
       <xs:documentation>
-        Document base URI
+        The HTML Base Element (&lt;base&gt;) specifies the base URL to use for all relative URLs contained within a document. There can be only one &lt;base&gt; element in a document.
       </xs:documentation>
     </xs:annotation>
     <xs:complexType>
@@ -5561,6 +5565,17 @@
     </xs:complexType>
   </xs:element>
   <xs:complexType name="htmlMeta">
+    <xs:annotation>
+      <xs:documentation>
+        The HTML Meta Element (&lt;meta&gt;) represents any metadata information that cannot be represented by one of the other HTML meta-related elements (&lt;base&gt;, &lt;link&gt;, &lt;script&gt;, &lt;style&gt; or &lt;title&gt;).
+
+        Depending on the attributes set, the kind of metadata can be one of the following:
+        - If name is set, it is document-level metadata, applying to the whole page.
+        - If http-equiv is set, it is a pragma directive, i.e. information normally given by the web server about how the - web page should be served.
+        - If charset is set, it is a charset declaration, i.e. the charset used for the serialized form of the webpage. HTML5
+        - if the itemprop is set, a user-defined metadata, transparent for the user-agent as the semantics of the metadata is user-specific.
+      </xs:documentation>
+    </xs:annotation>
     <xs:attributeGroup ref="i18n"/>
     <xs:attribute name="id" type="xs:ID"/>
     <xs:attribute name="http-equiv">
@@ -5773,7 +5788,7 @@
   <xs:element name="body">
     <xs:annotation>
       <xs:documentation>
-        The HTML &lt;body&gt; element represents the content of an HTML document. There is only one &lt;body&gt; element in a document.
+        The HTML Body Element (&lt;body&gt;) represents the content of an HTML document. There can be only one &lt;body&gt; element in a document.
       </xs:documentation>
     </xs:annotation>
     <xs:complexType>
@@ -5833,6 +5848,7 @@
       <xs:choice maxOccurs="unbounded" minOccurs="0">
         <xs:group ref="text-only"/>
       </xs:choice>
+      <xs:attributeGroup ref="coreattrs"/>
     </xs:complexType>
   </xs:element>
   <xs:element name="footer">
@@ -5847,6 +5863,7 @@
       <xs:choice maxOccurs="unbounded" minOccurs="0">
         <xs:group ref="text-only"/>
       </xs:choice>
+      <xs:attributeGroup ref="coreattrs"/>
     </xs:complexType>
   </xs:element>
   <xs:element name="aside">
@@ -5859,6 +5876,7 @@
       <xs:choice maxOccurs="unbounded" minOccurs="0">
         <xs:group ref="text-only"/>
       </xs:choice>
+      <xs:attributeGroup ref="coreattrs"/>
     </xs:complexType>
   </xs:element>
   <xs:element name="h1" type="headerContent">
@@ -6013,7 +6031,9 @@
   <xs:complexType name="ul-base">
     <xs:annotation>
       <xs:documentation>
-        Unordered list
+        The HTML unordered list element (&lt;ul&gt;) represents an unordered list of items, namely a collection of items that do not have a numerical ordering, and their order in the list is meaningless. Typically, unordered-list items are displayed with a bullet, which can be of several forms, like a dot, a circle or a squared. The bullet style is not defined in the HTML description of the page, but in its associated CSS, using the list-style-type property.
+        
+        There is no limitation to the depth and imbrication of lists defined with the &lt;ol&gt; and &lt;ul&gt; elements.
       </xs:documentation>
     </xs:annotation>
     <xs:attributeGroup ref="coreattrs"/>
@@ -6063,7 +6083,9 @@
   <xs:complexType name="ol-base">
     <xs:annotation>
       <xs:documentation>
-        Ordered list
+        The HTML &lt;ol&gt; Element (or HTML Ordered List Element) represents an ordered list of items. Typically, ordered-list items are displayed with a preceding numbering, which can be of any form, like numerals, letters or Romans numerals or even simple bullets. This numbered style is not defined in the HTML description of the page, but in its associated CSS, using the list-style-type property.
+        
+        There is no limitation to the depth and overlap of lists defined with the &lt;ol&gt; and &lt;ul&gt; elements.
       </xs:documentation>
     </xs:annotation>
     <xs:attributeGroup ref="coreattrs"/>
@@ -6114,7 +6136,7 @@
   <xs:complexType mixed="true" name="li-base">
     <xs:annotation>
       <xs:documentation>
-        List item
+        The HTML List Item Element (&lt;li&gt;) is used to represent an item in a list. It must be contained in a parent element: an ordered list (&lt;ol&gt;), an unordered list (&lt;ul&gt;), or a menu (&lt;menu&gt;). In menus and unordered lists, list items are usually displayed using bullet points. In ordered lists, they are usually displayed with an ascending counter on the left, such as a number or letter.
       </xs:documentation>
     </xs:annotation>
     <xs:attributeGroup ref="coreattrs"/>
@@ -6649,7 +6671,7 @@
   <xs:element name="span">
     <xs:annotation>
       <xs:documentation>
-        Inline style
+        The HTML &lt;span&gt; element is a generic inline container for phrasing content, which does not inherently represent anything. It can be used to group elements for styling purposes (using the class or id attributes), or because they share attribute values, such as lang. It should be used only when no other semantic element is appropriate. &lt;span&gt; is very much like a &lt;div&gt; element, but &lt;div&gt; is a block-level element whereas a &lt;span&gt; is an inline element.
       </xs:documentation>
     </xs:annotation>
     <xs:complexType mixed="true">
@@ -6778,14 +6800,14 @@
   <xs:element name="em" type="inlineBaseType">
     <xs:annotation>
       <xs:documentation>
-        Emphasis
+        The HTML Emphasis Element (&lt;em&gt;) marks text that has stress emphasis. The &lt;em&gt; element can be nested, with each level of nesting indicating a greater degree of emphasis.
       </xs:documentation>
     </xs:annotation>
   </xs:element>
   <xs:element name="strong" type="inlineBaseType">
     <xs:annotation>
       <xs:documentation>
-        Strong emphasis
+        The HTML Strong Element (&lt;strong&gt;) gives text strong importance, and is typically displayed in bold.
       </xs:documentation>
     </xs:annotation>
   </xs:element>
@@ -7123,13 +7145,7 @@
           </xs:union>
         </xs:simpleType>
       </xs:attribute>
-      <xs:attribute default="no" name="encrypturl" type="yesno-or-perl">
-        <xs:annotation>
-          <xs:documentation>
-            LON-CAPA specific attribute. If set to yes, the file URL will be hidden.
-          </xs:documentation>
-        </xs:annotation>
-      </xs:attribute>
+      <xs:attribute default="no" name="encrypturl" type="yesno-or-perl"/>
     </xs:complexType>
   </xs:element>
   <xs:element name="figure">
@@ -7155,6 +7171,7 @@
           <xs:element minOccurs="0" ref="figcaption"/>
         </xs:sequence>
       </xs:choice>
+      <xs:attributeGroup ref="coreattrs"/>
     </xs:complexType>
   </xs:element>
   <xs:element name="figcaption">
@@ -7271,7 +7288,7 @@
   <xs:element name="param">
     <xs:annotation>
       <xs:documentation>
-        param is used to supply a named property value
+        The HTML &lt;param&gt; element is used to supply a named property value.
       </xs:documentation>
     </xs:annotation>
     <xs:complexType>
@@ -7680,14 +7697,32 @@
     <xs:complexType mixed="true">
       <xs:complexContent>
         <xs:extension base="inlineBaseType">
-          <xs:attribute name="for" type="xs:IDREF"/>
+          <xs:attribute name="for" type="xs:IDREF">
+            <xs:annotation>
+              <xs:documentation>
+                The ID of a labelable form-related element in the same document as the label element. The first such element in the document with an ID matching the value of the for attribute is the labeled control for this label element. 
+              </xs:documentation>
+            </xs:annotation>
+          </xs:attribute>
           <xs:attribute name="accesskey">
+            <xs:annotation>
+              <xs:documentation>
+                A shortcut key to access this element from the keyboard.
+              </xs:documentation>
+            </xs:annotation>
             <xs:simpleType>
               <xs:restriction base="xs:string">
                 <xs:length fixed="true" value="1"/>
               </xs:restriction>
             </xs:simpleType>
           </xs:attribute>
+          <xs:attribute name="form" type="xs:IDREF">
+            <xs:annotation>
+              <xs:documentation>
+                The form element that the label element is associated with (its form owner). If specified, the value of the attribute must be the ID of a &lt;form&gt; element in the same document. This attribute enables you to place label elements anywhere within a document, not just as descendants of their form elements.
+              </xs:documentation>
+            </xs:annotation>
+          </xs:attribute>
           <xs:attribute name="onfocus" type="xs:string"/>
           <xs:attribute name="onblur" type="xs:string"/>
         </xs:extension>