You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by bo...@apache.org on 2013/05/28 13:24:47 UTC
svn commit: r1486874 - /commons/proper/compress/trunk/src/site/xdoc/zip.xml
Author: bodewig
Date: Tue May 28 11:24:47 2013
New Revision: 1486874
URL: http://svn.apache.org/r1486874
Log:
Java5 doesn't like Zip64 extra fields at all
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=1486874&r1=1486873&r2=1486874&view=diff
==============================================================================
--- commons/proper/compress/trunk/src/site/xdoc/zip.xml (original)
+++ commons/proper/compress/trunk/src/site/xdoc/zip.xml Tue May 28 11:24:47 2013
@@ -329,9 +329,14 @@
(see <a href="#ZipArchiveOutputStream">above</a>). If only
the uncompressed size is
known <code>ZipArchiveOutputStream</code> will assume the
- compressed size will not be bigger that the compressed
+ compressed size will not be bigger than the uncompressed
size.</p>
+ <p><code>ZipArchiveOutputStream</code>'s
+ <code>setUseZip64</code> can be used to control the behavior.
+ <code>Zip64Mode.AsNeeded</code> is the default behavior
+ described in the previous paragraph.</p>
+
<p>If <code>ZipArchiveOutputStream</code> is writing to a
non-seekable stream it has to decide whether to use Zip64
extensions or not before it starts wrtiting the entry data.
@@ -350,11 +355,6 @@
of them to be too big to fit into the traditional
limits.</p>
- <p><code>ZipArchiveOutputStream</code>'s <code>setUseZip64</code>
- can be used to control the change the default
- behavior. <code>Zip64Mode.AsNeeded</code> is the default
- behavior described in the previous paragraph.</p>
-
<p><code>Zip64Mode.Always</code> creates archives that use
Zip64 extensions for all entries, even those that don't
require them. Such archives will be slightly bigger than
@@ -373,6 +373,12 @@
in <code>Zip64Mode.AsNeeded</code> mode if some of the
entries had unknown sizes.</p>
+ <p>The <code>java.util.zip</code> package and the
+ <code>jar</code> command of Java5 and earlier can not read
+ Zip64 extensions and will fail if the archive contains any.
+ So if you intend to create archives that Java5 can consume
+ you must set the mode to <code>Zip64Mode.Never</code></p>
+
<h4>Known Limitations</h4>
<p>Some of the theoretical limits of the format are not