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: [email protected]
For additional commands, e-mail: [email protected]
