~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): tony mancill
  • Date: 2013-05-17 07:53:06 UTC
  • mfrom: (7.1.1 experimental)
  • Revision ID: package-import@ubuntu.com-20130517075306-4yt0jyr782vasejl
Tags: 1.5-1
* Team upload.
* Upload to unstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
447
447
        are used to load JAR files and are the base for the
448
448
        <code>jar</code> command line utility as well.</p>
449
449
      </subsection>
 
450
 
 
451
      <subsection name="Consuming Archives Completely">
 
452
 
 
453
        <p>Prior to version 1.5 <code>ZipArchiveInputStream</code>
 
454
        would return null from <code>getNextEntry</code> or
 
455
        <code>getNextZipEntry</code> as soon as the first central
 
456
        directory header of the archive was found, leaving the whole
 
457
        central directory itself unread inside the stream.  Starting
 
458
        with version 1.5 <code>ZipArchiveInputStream</code> will try
 
459
        to read the archive up to and including the "end of central
 
460
        directory" record effectively consuming the archive
 
461
        completely.</p>
 
462
 
 
463
      </subsection>
 
464
 
 
465
      <subsection name="Symbolic Links" id="symlinks">
 
466
 
 
467
        <p>Starting with Compress 1.5 <code>ZipArchiveEntry</code>
 
468
        recognizes Unix Symbolic Link entries written by InfoZIP's
 
469
        zip.</p>
 
470
 
 
471
        <p>The <code>ZipFile</code> class contains a convenience
 
472
        method to read the link name of an entry.  Basically all it
 
473
        does is read the contents of the entry and convert it to
 
474
        a string using the given file name encoding of the
 
475
        archive.</p>
 
476
 
 
477
      </subsection>
450
478
    </section>
451
479
  </body>
452
480
</document>