=====
atool
=====

atool is a script for managing file archives of various types (tar,
tar+gzip, zip, bzip2, rar, 7zip, ...).

The main command is aunpack which extracts files from an archive. Did
you ever extract files from an archive, not checking whether the files
were located in a subdirectory or in the top directory of the archive,
resulting in files scattered all over the place? aunpack overcomes
this problem by first extracting to a new directory. If there was only
a single file in the archive, that file is moved to the original
directory. aunpack also prevents local files from being overwritten by
mistake.

The other commands provided are apack (to create archives), als (to
list files in archives), acat (to extract files to standard out), and
adiff (to show differences between archives). As atool invokes
external programs to handle the archives, not all commands may be
supported for a certain type of archives.

atool identifies archives by their file extension. Sometimes this is
not possible - for instance rar archives sometimes have varying numeric
file extensions. In those cases when atool can't identify the format,
file is used instead. (atool can be configured not to use file.)

Source homepage:    http://www.nongnu.org/atool/
Source download:    http://savannah.nongnu.org/download/atool/atool-0.37.0.tar.gz
Author:             Oskar Liljeblad <oskar at osk.mine.nu>
Cygwin maintainer:  Andrew Schulman <andrex at alumni.utexas.net>
License:            GPL; see COPYING for details.

Please address questions and bug reports to the Cygwin mailing list
<cygwin at cygwin.com>.

-------------------------------------------------------------------------

Runtime requirements:
  perl

Build requirements:
  autoconf
  cygport
  make

Build instructions:
  cd /usr/src
  tar -jxf atool-0.39.0-1-src.tar.bz2
    if you use setup to install this src package, it will be
    unpacked under /usr/src automatically.
  cygport atool-0.39.0-1.cygport all

This will create:
  /usr/src/atool-0.39.0-1.tar.bz2
  /usr/src/atool-0.39.0-1-src.tar.bz2

Or use 'cygport atool-0.39.0-1.cygport prep' to create a patched source
directory.

-------------------------------------------------------------------------

Files included in the binary distribution:

  /usr/bin/acat
  /usr/bin/adiff
  /usr/bin/als
  /usr/bin/apack
  /usr/bin/arepack
  /usr/bin/atool
  /usr/bin/aunpack
  /usr/share/doc/Cygwin/atool.README (this file)
  /usr/share/doc/atool/COPYING
  /usr/share/doc/atool/ChangeLog
  /usr/share/doc/atool/NEWS
  /usr/share/doc/atool/README
  /usr/share/doc/atool/README.Cygwin (this file)
  /usr/share/doc/atool/TODO
  /usr/share/man/man1/acat.1.gz
  /usr/share/man/man1/adiff.1.gz
  /usr/share/man/man1/als.1.gz
  /usr/share/man/man1/apack.1.gz
  /usr/share/man/man1/arepack.1.gz
  /usr/share/man/man1/atool.1.gz
  /usr/share/man/man1/aunpack.1.gz

-------------------------------------------------------------------------

Cygwin version history (see /usr/share/doc/atool/NEWS for a complete list
of upstream changes):

0.39.0-1:
* New upstream release: add support for plzip, lbzip2, and pigz.

0.38.0-1:
* New upstream release: bug fixes.

0.37.0-1:
* New upstream release: add lzip and xv support; bug fixes.

0.36.0-1:
* New upstream release: bug fixes.

0.35.0-1:
* New upstream release:  add support for pbzip2, rzip, lrzip, SX zip;
  some new options and bug fixes.
* Fix too-specific invocation of /usr/bin/perl5.10.0 to /usr/bin/perl
  at top of atool.

0.34.0-2:
* Correct packaging error:  bad symlinks to atool.1.gz.

0.34.0-1:
* New upstream release:  add lzma support.

0.33.0-1:
* Initial Cygwin build.