home *** CD-ROM | disk | FTP | other *** search
/ Freelog 11 / Freelog011.iso / Bas / Compression / Wiz / README < prev    next >
Text File  |  1997-11-03  |  8KB  |  153 lines

  1. This is the README file for the 3 November 1997 public release
  2. of the Info-ZIP group's WiZ zipfile creation/extraction program
  3.  
  4. wiz40.zip       WiZ, version 4.0, source code distribution
  5. wiz40x.zip      WiZ, version 4.0, executables (16 bit)
  6. wiz40xN.zip     WiZ, version 4.0, executables (32 bit)
  7.  
  8. __________________________________________________________________________
  9.  
  10. BEFORE YOU ASK:  WiZ, UnZip, its companion utility Zip, and related utilities
  11. and support files can be found in many places; read the file "Where" for
  12. further details.  To contact the authors with suggestions, bug reports,
  13. or fixes, continue reading this file (README) and, if this is part of a
  14. source distribution, the file "ZipPorts" in the proginfo directory.  Also
  15. in source distributions:  read "BUGS" for a list of known bugs, non-bugs
  16. and possible future bugs; INSTALL for instructions on how to build UnZip;
  17. and "Contents" for a commented listing of all the distributed files.
  18. __________________________________________________________________________
  19.  
  20.  
  21. GENERAL INFO
  22. ------------
  23. WiZ is an compression/extraction utility for archives compressed in .zip
  24. format (also called "zipfiles").  Although highly compatible both with
  25. PKWARE's PKZIP and PKUNZIP utilities for MS-DOS and with Info-ZIP's own
  26. Zip program, our primary objectives have been portability and non-MSDOS
  27. functionality.
  28.  
  29. The extraction code in WiZ (UnZip) has been ported to a stupendous array of
  30. hardware--from micros to supercomputers--and operating systems:  Unix
  31. (many flavors), VMS, OS/2 (including DLL version), Windows NT and Windows
  32. 95 (including DLL version), Windows CE (GUI version), Windows 3.x (including
  33. DLL version), MS-DOS, AmigaDOS, Atari TOS, Acorn RISC OS, BeOS, Macintosh
  34. (GUI version), SMS/QDOS, MVS, VM/CMS, Human68k (mostly), AOS/VS (partly)
  35. and TOPS-20 (partly). UnZip features not found in PKUNZIP include source code;
  36. default extraction of directory trees (with a switch to defeat this, rather
  37. than the reverse); OS/2, VMS, Unix, RISC OS, Macintosh and BeOS extended
  38. file attributes; and, of course, the ability to run under most of your
  39. favorite operating systems. Plus, it's free. :-)
  40.  
  41. For source distributions, see the main Contents file for a list of what's
  42. included, and read INSTALL for instructions on compiling (including OS-
  43. specific comments).  The individual operating systems' Contents files (for
  44. example, vms/Contents) may list important compilation info in addition to
  45. explaining what files are what, so be sure to read them.  Some of the ports
  46. have their own, special README files, so be sure to look for those, too.
  47.  
  48. CHANGES AND NEW FEATURES
  49. ------------------------
  50.  
  51. This is actually the first release of WiZ. It is based on WizUnZip which
  52. was up to version 3.x. Wanting to keep the numbering sequencial due to the
  53. strong influence of WizUnZip, the decision was made to start with a numbering
  54. system that reflected this.
  55.  
  56.    - full Universal Time (UTC or GMT) support for trans-timezone consistency
  57.    - cross-platform support for 8-bit characters (ISO Latin-1, OEM code pages)
  58.    - support for NT security descriptors (ACLs)
  59.  
  60. What is (still!) not added is multi-part archive support (a.k.a. "diskette
  61. spanning") and a unified and more powerful DLL interface.  These are the
  62. two highest priorities for the 6.x releases.  Work on the former is almost
  63. certain to have commenced by the time you read this.  This time we mean it!
  64. Honest. ;-)
  65.  
  66.  
  67. INTERNET RESOURCES
  68. ------------------
  69.  
  70. Info-ZIP's web site is at http://www.cdrom.com/pub/infozip/ and contains the
  71. most up-to-date information about coming releases, links to binaries, and
  72. common problems.  (See http://www.cdrom.com/pub/infozip/FAQ.html for the
  73. latter.)  Files may also be retrieved via ftp://ftp.cdrom.com/pub/infozip/ .
  74. Thanks to Walnut Creek CD-ROM for hosting our primary site.
  75.  
  76.  
  77. DISTRIBUTION
  78. ------------
  79. If you have a question regarding redistribution of Info-ZIP software,
  80. either as-is, as packaging for a commercial product, or as an integral
  81. part of a commercial product, read the Frequently Asked Questions (FAQ)
  82. section of the included COPYING file.
  83.  
  84. Insofar as C compilers are rare on some platforms and the authors only have
  85. direct access to a subset of the supported systems, others may wish to pro-
  86. vide ready-to-run executables for new systems.  In general there is no prob-
  87. lem with this; we require only that such distributions include this README
  88. file, the Where file, the COPYING file (contains copyright/redistribution
  89. information), and the appropriate documentation files (unzip.doc and/or
  90. unzip.1 for UnZip, etc.).  If the local system provides a way to make self-
  91. extracting archives in which both the executables and text files can be
  92. stored together, that's best (in particular, use UnZipSFX if at all possible,
  93. even if it's a few kilobytes bigger than the alternatives); otherwise we
  94. suggest a bare UnZip executable and a separate zipfile containing the re-
  95. maining text and binary files.  If another archiving method is in common
  96. use on the target system (for example, Zoo or LHa), that may also be used.
  97.  
  98.  
  99. BUGS AND NEW PORTS:  CONTACTING INFO-ZIP
  100. ----------------------------------------
  101. All bug reports and patches (context diffs only, please!) should go to
  102. Zip-Bugs@lists.wku.edu, which is the e-mail address for the Info-ZIP
  103. authors.  (Note that a few rare systems require the Zip-Bugs part to be
  104. capitalized as shown; most systems work OK with lowercase "zip-bugs,"
  105. however.)  "Dumb questions" that aren't adequately answered in the docu-
  106. mentation should also be directed here rather than to a global forum such
  107. as Usenet.  (Kindly make certain that your question *isn't* answered by
  108. the documentation, however--a great deal of effort has gone into making
  109. it clear and complete.)
  110.  
  111. Suggestions for new features can be sent to info-zip@lists.wku.edu, a
  112. mailing list for the Info-ZIP beta testers, for discussion (the authors
  113. hang out here as well, of course).  We make no promises to act on all
  114. suggestions or even all patches, but if it is something that is manifestly
  115. useful, sending the required patches to Zip-Bugs directly (as per the
  116. instructions in the ZipPorts file) is likely to produce a quicker response
  117. than asking us to do it--the authors are always somewhat short on time.
  118. (Please do NOT send patches or encoded zipfiles to the info-zip address.
  119. Please DO read the ZipPorts file before sending any large patch.  It would
  120. be difficult to emphasize this point too much...)
  121.  
  122. If you are considering a port, not only should you read the ZipPorts file,
  123. but also please check in with Zip-Bugs BEFORE getting started, since the
  124. code is constantly being updated behind the scenes.  For example, VMOS,
  125. VxWorks and Netware ports are claimed to be under construction, although
  126. we have yet to see any up-to-date patches.  We will arrange to send you the
  127. latest sources.  The alternative is the possibility that your hard work will
  128. be tucked away in a sub-archive and mostly ignored, or completely ignored
  129. if someone else has already done the port (and you'd be surprised how often
  130. this has happened).
  131.  
  132.  
  133. BETA TESTING:  JOINING INFO-ZIP
  134. -------------------------------
  135. If you'd like to keep up to date with our WiZ, UnZip (and companion Zip
  136. utility) development, join the ranks of beta testers, add your own thoughts
  137. and contributions, etc., send a two-line mail message containing the commands
  138. HELP and LIST (on separate lines in the body of the message, not on the
  139. subject line) to mxserver@lists.wku.edu.  You'll receive two messages listing
  140. the various Info-ZIP mailing-list formats that are available (and also various
  141. unrelated lists) and instructions on how to subscribe to one or more of them
  142. (courtesy of Hunter Goatley).  As of mid-1997, subscribing to the announce-
  143. ments list requires a command of the form
  144.  
  145.     SUBSCRIBE Info-ZIP-announce "Joe Isuzu"
  146.  
  147. The discussion list is called Info-ZIP; it can be set for either normal or
  148. digest-style delivery.
  149.  
  150.  
  151. -- Mike White modified version of Greg Roelofs' (sometimes known as Cave Newt),
  152. readme file.
  153.