new documentation type "scriptalias" and more than one explanation (for code) allowed

git-svn-id: svn://svn.code.sf.net/p/actiongame/code/trunk/ac@5716 e016b1c5-ed68-44aa-a2f7-31cac88cffde

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">

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>

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>