UnZip 5.1 of 7 February 1994, by Info-ZIP.  Portions (c) 1989 by S. H. Smith.Send bug reports to authors at zip-bugs@wkuvx1.wku.edu; see README for details.Usage: unzip [-Z] [-opts[modifiers]] file[.zip] [list] [-x xlist] [-d exdir]  Default action is to extract files in list, except those in xlist, to exdir;  file[.zip] may be a wildcard.  "-Z" => ZipInfo mode (`unzip "-Z"' for usage).  -c  extract files to stdout/screen (CRT)   -l  list files (short format)  -p  extract files to pipe, no messages     -v  list files (verbose format)  -f  freshen existing files, create none    -t  test compressed archive data  -u  update files, create if necessary      -z  display archive comment  -x  exclude files which follow (in xlist)  -d  extract files into exdirmodifiers:                                   -q  quiet mode (-qq => quieter)  -n  never overwrite existing files         -a  auto-convert any text files  -o  overwrite files WITHOUT prompting      -aa treat ALL files as text  -j  junk paths (don't make directories)   "-U" don't make names lowercase "-X" restore owner/protection info         "-V" retain VMS version numbersExamples (see unzip.doc for more info):  unzip data1 -x joe   => extract all files except joe from zipfile data1.zip  unzip "-V" foo "Bar" => must quote uppercase options and filenames in VMS  unzip -fo foo vms.c  => quietly replace existing vms.c if archive file newer

BEFORE YOU ASK:  UnZip, its companion utility Zip, and related utilitiesand support files can be found in many places; read the file "Where" forfurther details.  To contact the authors with suggestions, bug reports,or fixes, continue reading this file (README) and, if this is part of asource distribution, the file "ZipRules".  Also in source distributions:read "BUGS" for a list of known bugs, non-bugs and possible future bugs,and see "Contents" for a commented listing of all the distributed files.ALSO NOTE:  Info-ZIP's mailing addresses have CHANGED AGAIN (since UnZip5.0p1 and Zip 2.0.1)!  See below.

GENERAL INFO------------UnZip is an extraction utility for archives compressed in .zip format (alsocalled "zipfiles").  Although highly compatible with PKWARE's PKZIP andPKUNZIP utilities for MS-DOS (in addition to Info-ZIP's own Zip program),our primary objectives have been portability and non-MSDOS functionality.This version of UnZip has been ported to a wide array of hardware--frommicros to supercomputers--and operating systems:  Unix (many flavors),VMS, OS/2, MSDOS (+ Windows), NT, TOPS-20 (partly), AmigaDOS, Atari TOS,Macintosh and Human68k.  UnZip features not found in PKUNZIP include sourcecode; default extraction of directory trees (with a switch to defeat this,rather than the reverse); VMS, Macintosh and OS/2 extended file attributes;and, of course, the ability to run under most of your favorite operatingsystems.  Plus, it's free. :-)For source distributions, see the main Contents file for a list of what'sincluded, and read INSTALL for instructions on compiling (including OS-specific comments).  The individual operating systems' Contents files (forexample, vms/Contents) may list important compilation info in addition toexplaining what files are what, so be sure to read them.  Some of the portshave their own, special README files, so be sure to look for those, too.See unzip.1 or unzip.doc for usage (or the corresponding ZipInfo and fUnZipdocs).  For VMS, unzip.rnh may be compiled into unzip.hlp and installed asa normal VMS help entry.NEW FEATURES------------New features in this version include the ability to extract to a directoryother than the current one; the inclusion of ZipInfo as an integral partof UnZip; wildcard zipfiles; full Amiga, Atari, Mac, NT and Human68K support(and partial TOPS-20 support); and funzip ports to most systems.  UnZip it-self still does not have the capability to extract zipfiles read from stdin,nor to extract multi-part archives.  Both of these features are planned forthe next version.DISTRIBUTION------------If you have a question regarding redistribution of Info-ZIP software,either as-is, as packaging for a commercial product, or as an integralpart of a commercial product, read the Frequently Asked Questions (FAQ)section of the included COPYING file.Insofar as C compilers are rare on some platforms and the authors onlyhave direct access to Unix, VMS, OS/2, MS-DOS, Mac, Amiga and Atarisystems, others may wish to provide ready-to-run executables.  There isno problem with this; we require only that such distributions includethis README file, the Where file, the COPYING file (contains copyright/redistribution information), and the appropriate documentation files(unzip.doc and/or unzip.1 for UnZip, etc.).  If the local system providesa way to make self-extracting archives in which both the executables andtext files may be stored together, that is best; otherwise we suggest abare UnZip executable and a separate zipfile containing the remainingtext and binary files.  If another archiving method is in common use onthe target system (for example, Zoo or LHa), that may also be used.BUGS AND NEW PORTS:  CONTACTING INFO-ZIP----------------------------------------All bug reports and patches (context diffs only, please!) should go tozip-bugs@wkuvx1.wku.edu, which is the e-mail address for the Info-ZIP au-thors.  Suggestions for new features can be sent to info-zip@wkuvx1.wku.edu,a mailing list for the Info-ZIP beta testers, for discussion (the authorshang out here as well, of course), although we don't promise to act onall suggestions.  If it is something which is manifestly useful, sendingthe required patches to zip-bugs directly is likely to produce a quickerresponse than asking us to do it--the authors are always somewhat shorton time.  (Please do NOT send patches to the info-zip address.)  If youare considering a port, however, please check in with the authors FIRST,since the code is constantly being updated behind the scenes (witnessthe new Amiga and Atari ports in this version; VMOS, Acorn/ARM, VM/CMS,Netware and QDOS ports are claimed to be under construction, although wehave yet to see any up-to-date patches).  We'll arrange to send you thelatest sources.  The alternative is the possibility that your hard workwill be tucked away in a sub-archive and pretty much ignored, or ignoredaltogether if someone else has already done the port (and you'd be surprisedhow often this has happened).BETA TESTING:  JOINING INFO-ZIP-------------------------------If you'd like to keep up to date with our UnZip (and companion Zip utility)development, join the ranks of beta testers, add your own thoughts and con-tributions, etc., send a two-line mail message containing the commands HELPand LIST (on separate lines in the body of the message, not on the subjectline) to mxserver@wkuvx1.wku.edu.  You'll receive two messages listing thevarious Info-ZIP mailing-list formats which are available (and also variousunrelated lists) and instructions on how to subscribe to one or more of them(courtesy of Hunter Goatley).Greg Roelofs (Cave Newt), UnZip maintainer/container/explainer anddeveloper guy, with inspiration from David Kirschbaum

Information Services, Central Computing
Universityof Missouri Kansas City