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

diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml
index 829caa5f2780b8d0583abb89cbb3655de0814d8b..8afe510b785f9bad6512e5ae677a101a24fa059f 100644 (file)
--- a/src/documentation/content/xdocs/faq.xml
+++ b/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>

diff --git a/src/documentation/content/xdocs/overview.xml b/src/documentation/content/xdocs/overview.xml
index bb8e0d2aeefae070c2f17bc713fedecddf2dbdad..35ae35f3805c35fcb6e906fc6ccbec47f958c019 100644 (file)
--- a/src/documentation/content/xdocs/overview.xml
+++ b/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.
-       The larger ooxml-schemas jar is only required for development.
+       poi-ooxml requires poi-ooxml-schemas. This is a substantially smaller 
+   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>

diff --git a/src/documentation/content/xdocs/status.xml b/src/documentation/content/xdocs/status.xml
index 0529403be2a503e37dfde18bbe7446c5f9f630bb..99c896ee879b58850ba0f83b6053d837bf0ec583 100644 (file)
--- a/src/documentation/content/xdocs/status.xml
+++ b/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>