Author: bodewig
Date: Tue Oct 11 15:39:05 2011
New Revision: 1181848
URL: http://svn.apache.org/viewvc?rev=1181848&view=rev
Log:
we know jar doesn't like all archives that other tools - including compress -
consider valid
Modified:
commons/proper/compress/trunk/src/site/xdoc/zip.xml
Modified: commons/proper/compress/trunk/src/site/xdoc/zip.xml
URL:
http://svn.apache.org/viewvc/commons/proper/compress/trunk/src/site/xdoc/zip.xml?rev=1181848&r1=1181847&r2=1181848&view=diff
==============================================================================
--- commons/proper/compress/trunk/src/site/xdoc/zip.xml (original)
+++ commons/proper/compress/trunk/src/site/xdoc/zip.xml Tue Oct 11 15:39:05 2011
@@ -432,6 +432,20 @@
</tr>
</tbody>
</table>
+
+ <h4>Known Interoperability Problems</h4>
+
+ <p>The <code>java.util.zip</code> package of OpenJDK7 supports
+ Zip 64 extensions but its <code>ZipInputStream</code> and
+ <code>ZipFile</code> classes will be unable to extract
+ archives created with Commons Compress 1.3's
+ <code>ZipArchiveOutputStream</code> if the archive contains
+ entries that use the data descriptor, are smaller than 4 GiB
+ and have Zip 64 extensions enabled. I.e. the classes in
+ OpenJDK currently only support archives that use Zip 64
+ extensions only when they are actually needed. These classes
+ are used to load JAR files and are the base for the
+ <code>jar</code> command line utility as well.</p>
</subsection>
</section>
</body>
