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