diff --git a/docs/schemas/cuberef.xsd b/docs/schemas/cuberef.xsd
index b4717e3d..692a4e0b 100644
--- a/docs/schemas/cuberef.xsd
+++ b/docs/schemas/cuberef.xsd
@@ -171,7 +171,7 @@
   <xs:complexType name="exampleType">
     <xs:sequence>
       <xs:element name="code" type="codeType" minOccurs="1" maxOccurs="1"/>
-      <xs:element name="explanation" type="descriptionType" minOccurs="0" maxOccurs="1"/>
+      <xs:element name="explanation" type="descriptionType" minOccurs="0" maxOccurs="unbounded"/>
     </xs:sequence>
   </xs:complexType>
 
@@ -198,6 +198,7 @@
     <xs:sequence>
       <xs:element name="command" type="commandType" minOccurs="0" maxOccurs="unbounded"/>
       <xs:element name="variable" type="variableType" minOccurs="0" maxOccurs="unbounded"/>
+      <xs:element name="scriptalias" type="scriptaliasType" minOccurs="0" maxOccurs="unbounded"/>
     </xs:sequence>
     <xs:attribute name="sort" type="xs:boolean" default="true"/>
   </xs:complexType>
@@ -223,6 +224,13 @@
     </xs:complexContent>
   </xs:complexType>
 
+  <xs:complexType name="scriptaliasType">
+    <xs:complexContent>
+      <xs:extension base="identifierType">
+      </xs:extension>
+    </xs:complexContent>
+  </xs:complexType>
+
     <!-- sections -->
   
   <xs:complexType name="sectionType">
diff --git a/docs/transformations/cuberef2cubescript.xslt b/docs/transformations/cuberef2cubescript.xslt
index 02db6da1..e42ec78f 100644
--- a/docs/transformations/cuberef2cubescript.xslt
+++ b/docs/transformations/cuberef2cubescript.xslt
@@ -109,7 +109,7 @@
           <xsl:text>[</xsl:text>
           <xsl:value-of select="normalize-space(t:code)"/>
           <xsl:text>] [</xsl:text>
-          <xsl:value-of select="normalize-space(t:explanation)"/>
+          <xsl:value-of select="normalize-space(t:explanation)"/><!-- FIXME: will only use the 1st explanation (2010oct06:flowtron) -->
           <xsl:text>];</xsl:text>
           <xsl:value-of select="$newline"/>
         </xsl:for-each>
diff --git a/docs/transformations/cuberef2xhtml.xslt b/docs/transformations/cuberef2xhtml.xslt
index 072c72e5..684d38fa 100644
--- a/docs/transformations/cuberef2xhtml.xslt
+++ b/docs/transformations/cuberef2xhtml.xslt
@@ -273,9 +273,11 @@
                                 <xsl:value-of select="t:code"/>
                               </div>
                               <xsl:if test="t:explanation">
+                                <xsl:for-each select="t:explanation">
                                 <div class="exampleExplanation">
-                                  <xsl:value-of select="t:explanation"/>
+                                  <xsl:value-of select="."/>
                                 </div>
+								</xsl:for-each>
                               </xsl:if>
                             </p>
                           </xsl:for-each>