poi-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From n...@apache.org
Subject svn commit: r1426098 - in /poi/site: publish/faq.html src/documentation/content/xdocs/faq.xml
Date Thu, 27 Dec 2012 01:35:13 GMT
Author: nick
Date: Thu Dec 27 01:35:13 2012
New Revision: 1426098

URL: http://svn.apache.org/viewvc?rev=1426098&view=rev
Log:
Add a FAQ entry on the source of the CT... classes

Modified:
    poi/site/publish/faq.html
    poi/site/src/documentation/content/xdocs/faq.xml

Modified: poi/site/publish/faq.html
URL: http://svn.apache.org/viewvc/poi/site/publish/faq.html?rev=1426098&r1=1426097&r2=1426098&view=diff
==============================================================================
--- poi/site/publish/faq.html (original)
+++ poi/site/publish/faq.html Thu Dec 27 01:35:13 2012
@@ -316,11 +316,17 @@ if (VERSION > 3) {
 </li>
 <li>
 <a name="faq-N10109-menu"></a><a href="#faq-N10109">
+      I can't seem to find the source for the OOXML CT.. classes, where do they
+      come from?
+    </a>
+</li>
+<li>
+<a name="faq-N10131-menu"></a><a href="#faq-N10131">
       An OLE2 ("binary") file is giving me problems, but I can't share it. How can I investigate
the problem on my own?
     </a>
 </li>
 <li>
-<a name="faq-N10123-menu"></a><a href="#faq-N10123">
+<a name="faq-N1014B-menu"></a><a href="#faq-N1014B">
       An OOXML ("xml") file is giving me problems, but I can't share it. How can I investigate
the problem on my own?
     </a>
 </li>
@@ -662,6 +668,37 @@ System.out.println("Core POI came from "
 <a name="faq-N10109"></a>
 <div class="h4">
 <h4>14. 
+      I can't seem to find the source for the OOXML CT.. classes, where do they
+      come from?
+    </h4>
+</div>
+       
+<p>The OOXML support in Apache POI is built on top of the file format
+         XML Schemas, as compiled into Java using 
+         <a href="http://xmlbeans.apache.org/">XMLBeans</a>. Currently,
+         the compilation is done with XMLBeans 2.3, for maximum compatibility
+         with installations. (You can use the resulting classes on the XMLBeans
+         2.3 runtime, or any later version of XMLBeans. If you are currently using
+         XMLBeans 2.2 or earlier, you will unfortunately have to upgrade, but this
+         isn't common any more).</p>
+        
+<p>All of the <em>org.openxmlformats.schemas.spreadsheetml.x2006</em> CT...
+         classes are auto-generated by XMLBeans. The resulting generated Java goes
+         in the <em>ooxml-schemas-src</em> jar, and the compiled version into
the
+         <em>ooxml-schemas</em> jar.</p>
+        
+<p>The full <em>ooxml-schemas</em> jar is distributed with Apache POI,

+         along with the cut-down <em>poi-ooxml-schemas</em> jar containing just
+         the common parts. The source jar isn't normally distributed with POI.
+         It is, however, available from Maven Central - ask your favourite Maven
+         mirror for the <em>ooxml-schemas-src</em> jar. Alternately, if you download
+         the POI source distribution (or checkout from SVN) and build, Ant will
+         automatically download the specification XML Schema, and compile it for 
+         you to generate the source and binary ooxml-schemas jars.</p>
+    
+<a name="faq-N10131"></a>
+<div class="h4">
+<h4>15. 
       An OLE2 ("binary") file is giving me problems, but I can't share it. How can I investigate
the problem on my own?
     </h4>
 </div>
@@ -684,9 +721,9 @@ System.out.println("Core POI came from "
         allow you to check that things are being read as you expect, and 
         narrow in on problem records and structures.</p>
     
-<a name="faq-N10123"></a>
+<a name="faq-N1014B"></a>
 <div class="h4">
-<h4>15. 
+<h4>16. 
       An OOXML ("xml") file is giving me problems, but I can't share it. How can I investigate
the problem on my own?
     </h4>
 </div>

Modified: poi/site/src/documentation/content/xdocs/faq.xml
URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/faq.xml?rev=1426098&r1=1426097&r2=1426098&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/faq.xml (original)
+++ poi/site/src/documentation/content/xdocs/faq.xml Thu Dec 27 01:35:13 2012
@@ -322,6 +322,34 @@ System.out.println("Core POI came from "
   </faq>
   <faq>
     <question>
+      I can't seem to find the source for the OOXML CT.. classes, where do they
+      come from?
+    </question>
+    <answer>
+       <p>The OOXML support in Apache POI is built on top of the file format
+         XML Schemas, as compiled into Java using 
+         <link href="http://xmlbeans.apache.org/">XMLBeans</link>. Currently,
+         the compilation is done with XMLBeans 2.3, for maximum compatibility
+         with installations. (You can use the resulting classes on the XMLBeans
+         2.3 runtime, or any later version of XMLBeans. If you are currently using
+         XMLBeans 2.2 or earlier, you will unfortunately have to upgrade, but this
+         isn't common any more).</p>
+        <p>All of the <em>org.openxmlformats.schemas.spreadsheetml.x2006</em>
CT...
+         classes are auto-generated by XMLBeans. The resulting generated Java goes
+         in the <em>ooxml-schemas-src</em> jar, and the compiled version into
the
+         <em>ooxml-schemas</em> jar.</p>
+        <p>The full <em>ooxml-schemas</em> jar is distributed with Apache
POI, 
+         along with the cut-down <em>poi-ooxml-schemas</em> jar containing just
+         the common parts. The source jar isn't normally distributed with POI.
+         It is, however, available from Maven Central - ask your favourite Maven
+         mirror for the <em>ooxml-schemas-src</em> jar. Alternately, if you download
+         the POI source distribution (or checkout from SVN) and build, Ant will
+         automatically download the specification XML Schema, and compile it for 
+         you to generate the source and binary ooxml-schemas jars.</p>
+    </answer>
+  </faq>
+  <faq>
+    <question>
       An OLE2 ("binary") file is giving me problems, but I can't share it. How can I investigate
the problem on my own?
     </question>
     <answer>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@poi.apache.org
For additional commands, e-mail: commits-help@poi.apache.org


Mime
View raw message