Notes on ooxml-schemas 1.1 and 1.0

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@954511 13f79535-47bb-0310-9956-ffa450edef68

src/documentation/content/xdocs/faq.xml

@@ -63,7 +63,7 @@ System.out.println("Core POI came from " + path);
        <em>org.openxmlformats.schemas</em> namespace.</p>
       <p>There are two jar files available, as described in
        <link href="/overview.html">the components overview section</link>.
-       The <em>full jar of all of the schemas is ooxml-schemas-1.0.jar</em>, 
+       The <em>full jar of all of the schemas is ooxml-schemas-1.1.jar</em>, 
        and it is currently around 15mb. The <em>smaller poi-ooxml-schemas 
        jar</em> is only about 4mb. This latter jar file only contains the 
        typically used parts though.</p>
@@ -72,11 +72,11 @@ System.out.println("Core POI came from " + path);
        classes that are typically used, as identified by the unit tests.
        Every so often, you may try to use part of the file format which
        isn't included in the minimal poi-ooxml-schemas jar. In this case,
-       you should switch to the full ooxml-schemas-1.0.jar. Longer term,
+       you should switch to the full ooxml-schemas-1.1.jar. Longer term,
        you may also wish to submit a new unit test which uses the extra
        parts of the XSDs, so that a future poi-ooxml-schemas jar will 
        include them.</p>
-      <p>There are a number of ways to get the full ooxml-schemas-1.0.jar.
+      <p>There are a number of ways to get the full ooxml-schemas-1.1.jar.
        If you are a maven user, see the 
        <link href="/overview.html">the components overview section</link>
        for the artifact details to have maven download it for you.
@@ -88,6 +88,12 @@ System.out.println("Core POI came from " + path);
        look at this). Finally, you can download the jar by hand from the
        <link href="http://www.ibiblio.org/maven/org.apache.poi/jars/">POI
        Maven Repository</link>.</p>
+      <p>Note that for POI 3.5 and 3.6, the full ooxml schemas jar was
+       named ooxml-schemas-1.0.jar. For POI 3.7, the filename was bumped
+       to ooxml-schemas-1.1.jar when generics support was added. You can
+       use ooxml-schemas-1.1.jar with POI 3.5 and 3.6 if you wish, but
+       POI 3.7 won't wokr with ooxml-schemas-1.0.jar (it needs thew newer
+       one).</p>
     </answer>
   </faq>
   <faq>

src/documentation/content/xdocs/overview.xml

@@ -247,15 +247,17 @@
         <tr>
           <td>ooxml-schemas</td>
 	  <td>xmlbeans</td>
-          <td>ooxml-schemas-1.0.jar</td>
+          <td>ooxml-schemas-1.1.jar</td>
         </tr>
       </table>
       <p>
 	(*) starting with 3.6-beta1-20091124.
       </p>
       <p>
-	poi-ooxml requires poi-ooxml-schemas. This is a substantially smaller version of the ooxml-schemas-1.0.jar.
+	poi-ooxml requires poi-ooxml-schemas. This is a substantially smaller 
-	The larger ooxml-schemas jar is only required for development.
+   version of the ooxml-schemas jar (ooxml-schemas-1.1.jar for POI 3.7 or later, ooxml-scheams-1.0.jar for POI 3.5 and 3.6).
+	The larger ooxml-schemas jar is <link href="faq.html">normally</link> 
+   only required for development
       </p>
     </section>
     <section><title>Examples</title>

src/documentation/content/xdocs/status.xml

@@ -118,6 +118,7 @@
            <action dev="POI-DEVELOPERS" type="fix">48339 - fixed ExternalNameRecord to properly distinguish DDE data from OLE data items </action>
            <action dev="POI-DEVELOPERS" type="fix">47920 - allow editing workbooks embedded into PowerPoint files</action>
            <action dev="POI-DEVELOPERS" type="add">48343 - added implementation of SUBTOTAL function</action>
+           <action dev="POI-DEVELOPERS" type="fix">Switch to compiling the OOXML Schemas for Java 1.5</action>
         </release>
         <release version="3.6" date="2009-12-14">
            <action dev="POI-DEVELOPERS" type="fix">48332 - fixed XSSFSheet autoSizeColumn() to tolerate empty RichTextString</action>