This is the README file for the 17 February 2002 public release of theInfo-ZIP group's portable UnZip zipfile-extraction program (and relatedutilities).unzip550.zip       portable UnZip, version 5.5, source code distributionunzip550.tar.Z     same as above, but compress'd tar formatunzip550.tar.gz    same as above, but gzip'd tar format__________________________________________________________________________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 "ZipPorts" in the proginfo directory.  Alsoin source distributions:  read "BUGS" for a list of known bugs, non-bugsand possible future bugs; INSTALL for instructions on how to build UnZip;and "Contents" for a commented listing of all the distributed files.__________________________________________________________________________GENERAL INFO------------UnZip is an extraction utility for archives compressed in .zip format (alsocalled "zipfiles").  Although highly compatible both with PKWARE's PKZIPand PKUNZIP utilities for MS-DOS and with Info-ZIP's own Zip program, ourprimary objectives have been portability and non-MSDOS functionality.This version of UnZip has been ported to a stupendous array of hardware--from micros to supercomputers--and operating systems:  Unix (many flavors),VMS, OS/2 (including DLL version), Windows NT and Windows 95 (including DLLversion), Windows CE (GUI version), Windows 3.x (including DLL version),MS-DOS, AmigaDOS, Atari TOS, Acorn RISC OS, BeOS, Macintosh (GUI version),SMS/QDOS, MVS, VM/CMS, FlexOS, Tandem NSK, Human68k (mostly), AOS/VS (partly)and TOPS-20 (partly).  UnZip features not found in PKUNZIP include sourcecode; default extraction of directory trees (with a switch to defeat this,rather than the reverse); system-specific extended file attributes; and, ofcourse, the ability to run under most of your favorite operating systems.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.txt for usage (or the corresponding UnZipSFX, ZipInfo,fUnZip and ZipGrep docs).  For VMS, unzip_def.rnh or unzip_cli.help may becompiled into unzip.hlp and installed as a normal VMS help entry; seevms/descrip.mms.CHANGES AND NEW FEATURES------------------------The main addition in the 5.5 release is support for PKWARE's new Deflate64(tm)algorithm, which appeared first in PKZIP 4.0 (published November 2000).As usual, some other bugfixes and clean-ups have been integrated:   - support for Deflate64 (Zip compression method #9)   - support for extracting VMS variable length record text files on     any system   - optional "cheap autorun" feature for the SFX stub   - security fixes:     * strip leading slash from stored pathspecs,     * remove "../" parent dir path components from extracted file names   - new option "-:" to allow verbatim extraction of file names containing     "../" parent dir path specs   - fixed file handle leak for the DLL code   - repaired OS2 & WinNT ACL extraction which was broken in 5.42The 5.42 maintance release fixes more bugs and cleans up the redistributionconditions:   - removal of unreduce.c and amiga/timelib.c code to get rid of the last     distribution restrictions beyond the BSD-like Info-ZIP LICENSE   - new generic timelib replacement (currently used by AMIGA port)   - more reasonable mapping rules of UNIX "leading-dot" filenames to the     DOS 8.3 name convention   - repaired screensize detection in MORE paging code     (was broken for DOS/OS2/WIN32 in 5.41)The 5.41 maintance release adds another new port and fixes some bugs.   - new BSD-like LICENSE   - new Novell Netware NLM port   - supports extraction of archives with more than 64k entries   - attribute handling of VMS port was broken in UnZip 5.4   - decryption support integrated in the main source distributionThe 5.4 release adds new ports, again. Other important items are changesto the listing format, new supplemental features and several bug fixes(especially concerning time-stamp handling...):   - new IBM OS/390 port, a UNIX derivate (POSIX with EBCDIC charset)   - complete revision of the MacOS port   - changed listing formats to enlarge the file size fields for more digits   - added capability to restore directory attributes on MSDOS, OS/2, WIN32   - enabled support of symbolic links on BeOS   - Unix: optional Acorn filetype support, useful for volumes exported via NFS   - several changes/additions to the DLL API   - GUI SFX stub for Win16 (Windows 3.1) and Win32 (Windows 9x, Windows NT)   - new free GCC compiler environments supported on WIN32   - many time-zone handling bug fixes for WIN32, AMIGA, ...The 5.32 release adds two new ports and a fix for at least one relativelyserious bug:   - new FlexOS port   - new Tandem NSK port   - new Visual BASIC support (compatibility with the Windows DLLs)   - new -T option (set zipfile timestamp) for virtually all ports   - fix for timestamps beyond 2038 (e.g., 2097; crashed under DOS/Win95/NT)   - fix for undetected "dangling" symbolic links (i.e., no pointee)   - fix for VMS indexed-file extraction problem (stored with Zip 2.0 or 2.1)   - further performance optimizationsThe 5.31 release included nothing but small bug-fixes and typo corrections,with the exception of some minor performance tweaks.The 5.3 release added still more ports and more cross-platform portabilityfeatures:   - new BeOS port   - new SMS/QDOS port   - new Windows CE graphical port   - VM/CMS port fully updated and tested   - MVS port fully updated and tested   - updated Windows DLL port, with WiZ GUI spun off to a separate package   - full Universal Time (UTC or GMT) support for trans-timezone consistency   - cross-platform support for 8-bit characters (ISO Latin-1, OEM code pages)   - support for NT security descriptors (ACLs)   - support for overwriting OS/2 directory EAs if -o option given   - updated Solaris/SVR4 package facilityWhat is (still!) not added is multi-part archive support (a.k.a. "diskettespanning") and a unified and more powerful DLL interface.  These are thetwo highest priorities for the 6.x releases.  Work on the former is almostcertain to have commenced by the time you read this.  This time we mean it!You betcha. :-)Although the DLLs are still basically a mess, the Windows DLLs (16- and 32-bit) now have some documentation and a small example application.  Note thatthey should now be compatible with C/C++, Visual BASIC and Delphi.  Weirderlanguages (FoxBase, etc.) are probably Right Out.Finally, note that support for unshrinking has now been turned OFF by default,although the source code is still available (as with unreducing).  This wasdone for legal reasons, not technical ones, and no, we're not any happierabout it than you are. :-(  See the COPYING file for details.INTERNET RESOURCES------------------Info-ZIP's web site is at http://www.info-zip.org/pub/infozip/and contains the most up-to-date information about coming releases,links to binaries, and common problems.(See http://www.info-zip.org/pub/infozip/FAQ.html for the latter.)Files may also be retrieved via ftp://ftp.info-zip.org/pub/infozip/ .Thanks to Walnut Creek CD-ROM for hosting our primary site.DISTRIBUTION------------If you have a question regarding redistribution of Info-ZIP software, eitheras is, as packaging for a commercial product, or as an integral part of acommercial product, please read the Frequently Asked Questions (FAQ) sectionof the included COPYING file.Insofar as C compilers are rare on some platforms and the authors only havedirect access to a subset of the supported systems, others may wish to pro-vide ready-to-run executables for new systems.  In general there is no prob-lem with this; we require only that such distributions include this READMEfile, the WHERE file, the COPYING file (contains copyright/redistributioninformation), and the appropriate documentation files (unzip.txt and/orunzip.1 for UnZip, etc.).  If the local system provides a way to make self-extracting archives in which both the executables and text files can bestored together, that's best (in particular, use UnZipSFX if at all possible,even if it's a few kilobytes bigger than the alternatives); otherwise wesuggest a bare UnZip executable and a separate zipfile containing the re-maining text and binary files.  If another archiving method is in commonuse on the 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@lists.wku.edu, which is the e-mail address for the Info-ZIPauthors.  (Note that a few rare systems require the Zip-Bugs part to becapitalized as shown; most systems work OK with lowercase "zip-bugs,"however.)  DO NOT MAIL US LARGE BINARIES--EVER.  If you need to send usa problem archive that happens to be large (> 20K), contact us first forinstructions."Dumb questions" that aren't adequately answered in the documentationshould also be directed to Zip-Bugs rather than to a global forum suchas Usenet.  (Kindly make certain that your question *isn't* answered bythe documentation, however--a great deal of effort has gone into makingit clear and complete.)Suggestions for new features can be discussed on Info-ZIP@lists.wku.edu,a mailing list for Info-ZIP beta testers and interested parties; you needto subscribe first, however (see below).  We make no promises to act on allsuggestions or even all patches, but if it is something that is manifestlyuseful, sending the required patches to Zip-Bugs directly (as per theinstructions in the ZipPorts file) is likely to produce a quicker responsethan asking us to do it--the authors are always ridiculously short on time.(Please do NOT send patches or encoded zipfiles to the Info-ZIP list.Please DO read the ZipPorts file before sending any large patch.  It wouldbe difficult to over-emphasize this point...)If you are considering a port, not only should you read the ZipPorts file,but also please check in with Zip-Bugs BEFORE getting started, since thecode is constantly being updated behind the scenes.  (For example, VxWorks,VMOS and Netware ports were once claimed to be under construction, althoughwe have yet to see any up-to-date patches.)  We will arrange to send you thelatest sources.  The alternative is the possibility that your hard work willbe tucked away in a subdirectory and mostly ignored, or completely ignoredif someone else has already done the port (and you'd be surprised how oftenthis 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, or simply lurk, send a two-line mail message containing thecommands HELP and LIST (on separate lines in the body of the message, noton the subject line) to mxserver@lists.wku.edu.  You'll receive two messageslisting the various Info-ZIP mailing-list formats that are available (andalso various unrelated lists) and instructions on how to subscribe to oneor more of them (courtesy of Hunter Goatley).  As of 1997, subscribing tothe announcements list required a command of the form        SUBSCRIBE Info-ZIP-announce "Joe Isuzu"The discussion list is called Info-ZIP; it can be set for either normal ordigest-style delivery.-- Greg Roelofs (sometimes known as Cave Newt), principal UnZip developer   guy, with inspiration from David Kirschbaum, was Author of this text.-- Christian Spieler (shorthand: SPC), current UnZip maintance coordinator,   applied the most recent changes.