← Back to branch summary

~ubuntu-branches/ubuntu/utopic/libcommons-compress-java/utopic

« back to all changes in this revision

Viewing changes to src/site/xdoc/zip.xml

  • Committer: Package Import Robot
  • Author(s): Emmanuel Bourg
  • Date: 2013-11-02 13:55:47 UTC
  • mfrom: (1.1.5)
  • Revision ID: package-import@ubuntu.com-20131102135547-nhcubj3ae7rv6t13
Tags: 1.6-1
* New upstream release
* Updated Standards-Version to 3.9.5 (no changes)
* Build depend on debhelper >= 9
* Removed the unused debian/orig-tar.sh script

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/site/xdoc/zip.xml
329
329
          (see <a href="#ZipArchiveOutputStream">above</a>).  If only
330
330
          the uncompressed size is
331
331
          known <code>ZipArchiveOutputStream</code> will assume the
332
 
          compressed size will not be bigger that the compressed
 
332
          compressed size will not be bigger than the uncompressed
333
333
          size.</p>
334
334
 
 
335
        <p><code>ZipArchiveOutputStream</code>'s
 
336
          <code>setUseZip64</code> can be used to control the behavior.
 
337
          <code>Zip64Mode.AsNeeded</code> is the default behavior
 
338
          described in the previous paragraph.</p>
 
339
 
335
340
        <p>If <code>ZipArchiveOutputStream</code> is writing to a
336
341
          non-seekable stream it has to decide whether to use Zip64
337
342
          extensions or not before it starts wrtiting the entry data.
350
355
          of them to be too big to fit into the traditional
351
356
          limits.</p>
352
357
 
353
 
        <p><code>ZipArchiveOutputStream</code>'s <code>setUseZip64</code>
354
 
          can be used to control the change the default
355
 
          behavior.  <code>Zip64Mode.AsNeeded</code> is the default
356
 
          behavior described in the previous paragraph.</p>
357
 
 
358
358
        <p><code>Zip64Mode.Always</code> creates archives that use
359
359
          Zip64 extensions for all entries, even those that don't
360
360
          require them.  Such archives will be slightly bigger than
373
373
          in <code>Zip64Mode.AsNeeded</code> mode if some of the
374
374
          entries had unknown sizes.</p>
375
375
 
 
376
        <p>The <code>java.util.zip</code> package and the
 
377
          <code>jar</code> command of Java5 and earlier can not read
 
378
          Zip64 extensions and will fail if the archive contains any.
 
379
          So if you intend to create archives that Java5 can consume
 
380
          you must set the mode to <code>Zip64Mode.Never</code></p>
 
381
 
376
382
        <h4>Known Limitations</h4>
377
383
 
378
384
        <p>Some of the theoretical limits of the format are not