You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@poi.apache.org by ni...@apache.org on 2015/03/13 16:57:12 UTC

svn commit: r1666492 - in /poi/site: publish/changes.html publish/changes.rss publish/faq.html src/documentation/content/xdocs/faq.xml

Author: nick
Date: Fri Mar 13 15:57:12 2015
New Revision: 1666492

URL: http://svn.apache.org/r1666492
Log:
FAQ entry on mixing jars from different versions

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

Modified: poi/site/publish/changes.html
URL: http://svn.apache.org/viewvc/poi/site/publish/changes.html?rev=1666492&r1=1666491&r2=1666492&view=diff
==============================================================================
--- poi/site/publish/changes.html (original)
+++ poi/site/publish/changes.html Fri Mar 13 15:57:12 2015
@@ -257,6 +257,9 @@ if (VERSION > 3) {
 <ul>
         
 <li>
+<img class="icon" alt="fix" src="images/fix.jpg"> <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=56467">56467</a> - Fix cloning of sheets with pictures</li>
+        
+<li>
 <img class="icon" alt="add" src="images/add.jpg"> More helpful ExtractorFactory exception if given a Visio VSDX ooxml file</li>
         
 <li>

Modified: poi/site/publish/changes.rss
URL: http://svn.apache.org/viewvc/poi/site/publish/changes.rss?rev=1666492&r1=1666491&r2=1666492&view=diff
==============================================================================
--- poi/site/publish/changes.rss (original)
+++ poi/site/publish/changes.rss Fri Mar 13 15:57:12 2015
@@ -1,3 +1,3 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <!DOCTYPE rss PUBLIC "-//Netscape Communications//DTD RSS 0.91//EN" "http://my.netscape.com/publish/formats/rss-0.91.dtd">
-<rss version="0.91"><channel><title>POI Changes</title><link>http://poi.apache.org/changes.html</link><description>POI Changes</description><language>en-us</language><item><title> add</title><link>http://poi.apache.org/changes.html</link><description> add by POI Developers - More helpful ExtractorFactory exception if given a Visio VSDX ooxml file</description></item><item><title> fix(bug 56799)</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers (bug 56799) - Include CTTblGrid in the smaller poi-ooxml-schemas jar</description></item><item><title> fix(bug 57165)</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers (bug 57165) - Avoid PartAlreadyExistsException when removing/cloning sheets</description></item><item><title> fix(bug 56893)</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers (bug 56893) - Additional check for supported string-length to avoid creating broken XL
 S files later one</description></item><item><title> fix</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers - When saving an OPCPackage with no Core Properties (eg from Jasper Reports), ensure they are always added even if not yet used</description></item><item><title> fix</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers - github-18 - Handle documents with a picture-only header</description></item><item><title> fix(bug 57622)</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers (bug 57622) - Change from XMLEventFactory.newFactory to XMLEventFactory.newInstance, for IBM JDK Compatibility</description></item></channel></rss>
\ No newline at end of file
+<rss version="0.91"><channel><title>POI Changes</title><link>http://poi.apache.org/changes.html</link><description>POI Changes</description><language>en-us</language><item><title> fix(bug 56467)</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers (bug 56467) - Fix cloning of sheets with pictures</description></item><item><title> add</title><link>http://poi.apache.org/changes.html</link><description> add by POI Developers - More helpful ExtractorFactory exception if given a Visio VSDX ooxml file</description></item><item><title> fix(bug 56799)</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers (bug 56799) - Include CTTblGrid in the smaller poi-ooxml-schemas jar</description></item><item><title> fix(bug 57165)</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers (bug 57165) - Avoid PartAlreadyExistsException when removing/cloning sheets</description></item><item><title> fi
 x(bug 56893)</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers (bug 56893) - Additional check for supported string-length to avoid creating broken XLS files later one</description></item><item><title> fix</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers - When saving an OPCPackage with no Core Properties (eg from Jasper Reports), ensure they are always added even if not yet used</description></item><item><title> fix</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers - github-18 - Handle documents with a picture-only header</description></item><item><title> fix(bug 57622)</title><link>http://poi.apache.org/changes.html</link><description> fix by POI Developers (bug 57622) - Change from XMLEventFactory.newFactory to XMLEventFactory.newInstance, for IBM JDK Compatibility</description></item></channel></rss>
\ No newline at end of file

Modified: poi/site/publish/faq.html
URL: http://svn.apache.org/viewvc/poi/site/publish/faq.html?rev=1666492&r1=1666491&r2=1666492&view=diff
==============================================================================
--- poi/site/publish/faq.html (original)
+++ poi/site/publish/faq.html Fri Mar 13 15:57:12 2015
@@ -340,6 +340,11 @@ if (VERSION > 3) {
       Why do I get a java.lang.NoClassDefFoundError: javax/xml/stream/XMLEventFactory.newFactory()
     </a>
 </li>
+<li>
+<a name="faq-N1019C-menu"></a><a href="#faq-N1019C">
+      Can I mix POI jars from different versions?
+    </a>
+</li>
 </ol>
 <a name="Answers"></a>
 <div class="h3">
@@ -826,6 +831,26 @@ System.out.println("Core POI came from "
 	  
 </ul>
     
+<a name="faq-N1019C"></a>
+<div class="h4">
+<h4>19. 
+      Can I mix POI jars from different versions?
+    </h4>
+</div>
+      
+<p>No. This is not supported.</p>
+      
+<p>All POI jars in use must come from the same version. A combination
+        such as <em>poi-3.11.jar</em> and <em>poi-ooxml-3.9.jar</em> is not
+        supported, and will fail to work in unpredictable ways.</p>
+      
+<p>If you're not sure which POI jars you're using at runtime, and/or
+        you suspect it might not be the one you intended, see 
+        <a href="#faq-N10006">this FAQ entry</a> for details on
+        diagnosing it. If you aren't sure what POI jars you need, see the
+        <a href="overview.html#components">Components Overview</a>
+        for details</p>
+    
 </div>
 </div>
 </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=1666492&r1=1666491&r2=1666492&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/faq.xml (original)
+++ poi/site/src/documentation/content/xdocs/faq.xml Fri Mar 13 15:57:12 2015
@@ -453,4 +453,21 @@ System.out.println("Core POI came from "
 	  </ul>
     </answer>
   </faq>
+  <faq>
+    <question>
+      Can I mix POI jars from different versions?
+    </question>
+    <answer>
+      <p>No. This is not supported.</p>
+      <p>All POI jars in use must come from the same version. A combination
+        such as <em>poi-3.11.jar</em> and <em>poi-ooxml-3.9.jar</em> is not
+        supported, and will fail to work in unpredictable ways.</p>
+      <p>If you're not sure which POI jars you're using at runtime, and/or
+        you suspect it might not be the one you intended, see 
+        <link href="#faq-N10006">this FAQ entry</link> for details on
+        diagnosing it. If you aren't sure what POI jars you need, see the
+        <link href="overview.html#components">Components Overview</link>
+        for details</p>
+    </answer>
+  </faq>
 </faqs>



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