home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / packer / unzip / readme < prev    next >
Text File  |  1994-02-06  |  6KB  |  120 lines
  1. This is the README file for the 7 February 1994 public release of the
  2. Info-ZIP group's portable UnZip zipfile-extraction program (and related
  3. utilities).
  4.  
  5. unzip51.zip    portable UnZip, version 5.1, source code distribution
  6. unzip51.zoo    same as above, but ZOO format
  7. unzip51.tar.Z    same as above, but compress'd tar format
  8.  
  9. __________________________________________________________________________
  10.  
  11. BEFORE YOU ASK:  UnZip, its companion utility Zip, and related utilities
  12. and support files can be found in many places; read the file "Where" for
  13. further details.  To contact the authors with suggestions, bug reports,
  14. or fixes, continue reading this file (README) and, if this is part of a
  15. source distribution, the file "ZipRules".  Also in source distributions:
  16. read "BUGS" for a list of known bugs, non-bugs and possible future bugs,
  17. and see "Contents" for a commented listing of all the distributed files.
  18.  
  19. ALSO NOTE:  Info-ZIP's mailing addresses have CHANGED AGAIN (since UnZip
  20. 5.0p1 and Zip 2.0.1)!  See below.
  21. __________________________________________________________________________
  22.  
  23.  
  24. GENERAL INFO
  25. ------------
  26. UnZip is an extraction utility for archives compressed in .zip format (also
  27. called "zipfiles").  Although highly compatible with PKWARE's PKZIP and 
  28. PKUNZIP utilities for MS-DOS (in addition to Info-ZIP's own Zip program),
  29. our primary objectives have been portability and non-MSDOS functionality.
  30.  
  31. This version of UnZip has been ported to a wide array of hardware--from 
  32. micros to supercomputers--and operating systems:  Unix (many flavors),
  33. VMS, OS/2, MSDOS (+ Windows), NT, TOPS-20 (partly), AmigaDOS, Atari TOS,
  34. Macintosh and Human68k.  UnZip features not found in PKUNZIP include source
  35. code; default extraction of directory trees (with a switch to defeat this, 
  36. rather than the reverse); VMS, Macintosh and OS/2 extended file attributes; 
  37. and, of course, the ability to run under most of your favorite operating 
  38. systems.  Plus, it's free. :-)
  39.  
  40. For source distributions, see the main Contents file for a list of what's
  41. included, and read INSTALL for instructions on compiling (including OS-
  42. specific comments).  The individual operating systems' Contents files (for 
  43. example, vms/Contents) may list important compilation info in addition to 
  44. explaining what files are what, so be sure to read them.  Some of the ports 
  45. have their own, special README files, so be sure to look for those, too.
  46.  
  47. See unzip.1 or unzip.doc for usage (or the corresponding ZipInfo and fUnZip
  48. docs).  For VMS, unzip.rnh may be compiled into unzip.hlp and installed as
  49. a normal VMS help entry.
  50.  
  51.  
  52. NEW FEATURES
  53. ------------
  54. New features in this version include the ability to extract to a directory
  55. other than the current one; the inclusion of ZipInfo as an integral part
  56. of UnZip; wildcard zipfiles; full Amiga, Atari, Mac, NT and Human68K support
  57. (and partial TOPS-20 support); and funzip ports to most systems.  UnZip it-
  58. self still does not have the capability to extract zipfiles read from stdin,
  59. nor to extract multi-part archives.  Both of these features are planned for 
  60. the next version.
  61.  
  62.  
  63. DISTRIBUTION
  64. ------------
  65. If you have a question regarding redistribution of Info-ZIP software,
  66. either as-is, as packaging for a commercial product, or as an integral
  67. part of a commercial product, read the Frequently Asked Questions (FAQ)
  68. section of the included COPYING file.
  69.  
  70. Insofar as C compilers are rare on some platforms and the authors only
  71. have direct access to Unix, VMS, OS/2, MS-DOS, Mac, Amiga and Atari 
  72. systems, others may wish to provide ready-to-run executables.  There is 
  73. no problem with this; we require only that such distributions include 
  74. this README file, the Where file, the COPYING file (contains copyright/
  75. redistribution information), and the appropriate documentation files 
  76. (unzip.doc and/or unzip.1 for UnZip, etc.).  If the local system provides 
  77. a way to make self-extracting archives in which both the executables and 
  78. text files may be stored together, that is best; otherwise we suggest a 
  79. bare UnZip executable and a separate zipfile containing the remaining 
  80. text and binary files.  If another archiving method is in common use on
  81. the target system (for example, Zoo or LHa), that may also be used.
  82.  
  83.  
  84. BUGS AND NEW PORTS:  CONTACTING INFO-ZIP
  85. ----------------------------------------
  86. All bug reports and patches (context diffs only, please!) should go to 
  87. zip-bugs@wkuvx1.wku.edu, which is the e-mail address for the Info-ZIP au-
  88. thors.  Suggestions for new features can be sent to info-zip@wkuvx1.wku.edu,
  89. a mailing list for the Info-ZIP beta testers, for discussion (the authors
  90. hang out here as well, of course), although we don't promise to act on
  91. all suggestions.  If it is something which is manifestly useful, sending 
  92. the required patches to zip-bugs directly is likely to produce a quicker 
  93. response than asking us to do it--the authors are always somewhat short 
  94. on time.  (Please do NOT send patches to the info-zip address.)  If you
  95. are considering a port, however, please check in with the authors FIRST,
  96. since the code is constantly being updated behind the scenes (witness
  97. the new Amiga and Atari ports in this version; VMOS, Acorn/ARM, VM/CMS,
  98. Netware and QDOS ports are claimed to be under construction, although we
  99. have yet to see any up-to-date patches).  We'll arrange to send you the
  100. latest sources.  The alternative is the possibility that your hard work 
  101. will be tucked away in a sub-archive and pretty much ignored, or ignored 
  102. altogether if someone else has already done the port (and you'd be surprised
  103. how often this has happened).
  104.  
  105.  
  106. BETA TESTING:  JOINING INFO-ZIP
  107. -------------------------------
  108. If you'd like to keep up to date with our UnZip (and companion Zip utility)
  109. development, join the ranks of beta testers, add your own thoughts and con-
  110. tributions, etc., send a two-line mail message containing the commands HELP
  111. and LIST (on separate lines in the body of the message, not on the subject
  112. line) to mxserver@wkuvx1.wku.edu.  You'll receive two messages listing the 
  113. various Info-ZIP mailing-list formats which are available (and also various
  114. unrelated lists) and instructions on how to subscribe to one or more of them
  115. (courtesy of Hunter Goatley).
  116.  
  117.  
  118. Greg Roelofs (Cave Newt), UnZip maintainer/container/explainer and
  119. developer guy, with inspiration from David Kirschbaum
  120.