home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / compress / filearchivers / zip201 / readme.ami < prev    next >
Text File  |  1995-02-27  |  9KB  |  220 lines
  1.  
  2. Info-Zip Zip 2.0.1 Executables for Amiga -- exportable compilation
  3. ========================================================================
  4.  
  5. Date:  September 21, 1993
  6.  
  7. Authors:  The Info-Zip internet group, original coding by
  8.           Mark Adler, Richard Wales, and Jean-loup Gailly.
  9.           See the "infozip.who" file for a complete list of
  10.           contributors.
  11.  
  12. What
  13. ----
  14.  
  15. Zip is a directory and file compression and archiving utility.  Zip
  16. provides a rich set of file management and manipulation commands,
  17. including splitting of large archives, selection of compression
  18. methods, and wild card inclusion and exclusion features.  It is
  19. compatible with PKZIP version 2.04g (but is not a PKZIP clone).
  20. Info-Zip's Zip is free, and runs on a wide variety of Unix and
  21. proprietary system platforms.
  22.  
  23. A companion utility, Unzip, is also provided by Info-Zip, and is
  24. developed by other members of the group.  Chances are, you can 
  25. obtain the most current version of Unzip from the same place you
  26. obtained this.
  27.  
  28. These utilities have also been referred to as "Portable Zip and Unzip".
  29.  
  30. See the file, "zip.doc" for a description of the included utilities and
  31. how to use them.
  32.  
  33.  
  34. Amiga Contacts
  35. --------------
  36.  
  37.   SAS/C porting and Zip-Bugs support for Amiga:
  38.         John Bush <john.bush@east.sun.com>
  39.  
  40.   Aztec Manx and general improvements (wild cards, assembler code, ...)
  41.         Paul Kienitz <paul.kienitz@f28.n125.z1.fidonet.org>
  42.  
  43.   Original 68000 assembler version of match.a subroutine:
  44.         Carsten Steger <stegerc@informatik.tu-muenchen.de>
  45.  
  46.  
  47. Primary repositories
  48. --------------------
  49.  
  50.   1.  Internet:  ftp.uu.net:/pub/archiving/zip/AMIGA/
  51.                  Index          -- text file listing contents
  52.                  zip201x.zip    -- zip archive for those with unzip
  53.                  zip201x.lha    -- lha archive for those without unzip
  54.  
  55.       If you don't have lha or unzip, then first obtain the latest
  56.       version of UnZip from the same directory.
  57.  
  58.   2.  Dialup: BIX "AMIGA" files section -- zip201x.lha
  59.  
  60.       Excerpts from the Index and README.AMI files will be posted with 
  61.       the file description in the BBS version.   PLEASE PRESERVE IT IF 
  62.       UPLOADED ELSEWHERE.
  63.  
  64.  
  65. Changes from beta version
  66. -------------------------
  67.  
  68. See the "history" file for a list of generic changes.
  69.         
  70. 1.  Recompilation using SAS/C version 6.3 eliminated a bug using
  71.     "zip -l", which caused 2 line feeds to be generated instead of
  72.     CR LF.
  73.  
  74. 2.  Support for an assembler version of longest_match() has been 
  75.     included.  Performance improvement is anywhere from 5% to
  76.     25% better than the original beta executables, depending on
  77.     input data and cpu model.
  78.  
  79. 3.  Improved wildcard support.
  80.  
  81.  
  82. NOTES
  83. ========================================================================
  84.  
  85. Encryption
  86. --------
  87. This distributed executable does not support encryption.  However,
  88. encryption is optionally available for Info-Zip's Zip.  If you have a SAS/C 
  89. version 6.3+ Manx Aztec version 5.2+ compiler, you can obtain the source
  90. code from a non-USA based location where it was developed, and
  91. recompile with encryption enabled.  See the file, "Where" for information
  92. on obtaining sources.  
  93.  
  94. The ZipCloak command was removed, because without encryption, it just
  95. reports that encryption is not supported.  This saved 30kB of space.
  96.  
  97. If you are Internet accessible within the USA, but don't have access
  98. to one of the above mentioned compilers, I will email you a
  99. uuencoded copy of an executable with encryption enabled.  HOWEVER, to 
  100. qualify for this, you must conform to the following.  I will ignore any 
  101. request without follow-up that doesn't provide the following information:
  102.  
  103.        1.  You must reside in the USA with a US-based internet domain
  104.        address.
  105.  
  106.        2.  You must not promise not to upload the encryption enabled 
  107.        executable to any publicly accessible source.
  108.  
  109.   I reserve the right not to respond to requests if I can't do this 
  110.   in my spare time!  (but I'll do my best)
  111.  
  112.   Requests to:  John Bush <john.bush@east.sun.com>
  113.  
  114. Pipes
  115. -----
  116. Certain features can not be equally represented on all platforms.
  117. Some examples in the online manual page file (zip.doc) are subject 
  118. to interpretation for the Amiga platform.  For example, true pipes are 
  119. not supported on Amiga.  The Amiga PIPE: "pseudo device" is not capable 
  120. of adequate support for Zip.  Therefore, support is limited for pipe 
  121. operations, and Amiga users should not expect that functionality to work 
  122. until we specifically implement and announce support for it.
  123.  
  124. I acknowledge that some 3rd parties, such as Matt Dillon and William
  125. Hawes, have improved the pipe device on Amiga, but the trick is to
  126. standardize this support, get Commodore to support it, and port 
  127. the capability to the other unix-like utilities such as tar, dd, cpio, etc.
  128. I think I'd rather go over Niagra Falls in a kayak loaded with cinder blocks.
  129.  
  130. Unix utilities
  131. --------------
  132. By default, the Amiga doesn't provide some utilities mentioned in zip.doc,
  133. such as tar and dd.  However, ports of the Gnu versions of these
  134. utilities are available from most internet servers that carry Amiga
  135. files, such as ftp.luth.se.
  136.  
  137. Current directory specifier
  138. ---------------------------
  139. The Amiga also doesn't allow "." (dot character) to specify the current
  140. directory.  Instead, Amiga expects a NULL string ("") to specify the
  141. current directory.  This construct WILL NOT WORK with Zip yet.
  142.  
  143. Wildcards
  144. ---------
  145. Wildcard selection is supported.  In addition to the basic regular
  146. expression interpretation as described in the section on PATTERN
  147. MATCHING in zip.doc, we have provided limited Amiga-style support.  The
  148. "#?" combination is treated exactly like "*" which matches any number
  149. of any characters.  However, the "#" by itself is not supported except
  150. when in combination with the "?".
  151.  
  152. One extension not described in zip.doc is the use of "^" in wildcard
  153. strings.  Specifically, "[^x]" will match any name NOT CONTAINING "x".
  154. The "^" prefix in a bracketed string negates the expression which
  155. follows.  For example, the expression "#?.[^o]" will match all names
  156. ending with a single character filename extension, excluding those that
  157. end with ".o".
  158.  
  159. The zip.doc file also talks about "escaping" wildcard specifiers
  160. to be passed to Zip, to prevent interpretation by the host shell.
  161. This is not neccessary in the Amiga version.
  162.  
  163. Path stripping
  164. --------------
  165. Directory paths can normally be stripped from stored files by
  166. specifying "zip -j".  However, even if "-j" is NOT specified, the Amiga
  167. version of Zip will strip volume names and leading slashes from stored
  168. names.
  169.  
  170.  
  171. Compatibility with UnZip and PKZIP
  172. ----------------------------------
  173.  
  174. Files produced by this version of Zip can be un-archived with
  175. Info-Zip's unzip version 5.0p1 or higher.  The previous Amiga release
  176. was UnZip version 5.1d3, dated February 23, 1993, which is compatible.
  177.  
  178. It is also compatible with PKUNZIP 2.04g and above for DOS.
  179.  
  180. Two options are provided with Zip 2.0.1 to assist in conversion between
  181. DOS and Unix.  The "-l" and "-ll" options convert text files between LF
  182. and CR LF forms of delimiters.
  183.  
  184. In addition, the "-k" option is provided to remap filenames and
  185. attributes to MSDOS form.  Be careful using the "-k" option,
  186. especially if the transfer is bidirectional, since full filename
  187. information will be irreversibly converted to DOS naming conventions.
  188. What this means is all filenames will be truncated to "8.3" format,
  189. and translated to upper case.  Characters not allowed in DOS will be
  190. filtered or translated, and the host-made-by field will be faked to
  191. indicate DOS.  Normally, it is best to name files in the first place
  192. according to the lowest common denominator where they will be used,
  193. rather than wrestle with such conversions.
  194.  
  195. If creating zip archives to be restored on a DOS machine that has
  196. PKUNZIP version 1.1, encourage your destination user to obtain the DOS
  197. version of Info-Zip unzip (UNZIP.EXE), or PKZIP version 2.04g or better.
  198. This will allow you to transfer archives using the best form of compression.
  199. If you have to exchange files with earlier releases of PKUNZIP, then you
  200. must avoid the "deflation" method of compression (also known as type 8),
  201. by always specifying the "-0" option with Zip.  This performs a
  202. "store only" operation.  Users of earlier releases of PKUNZIP have the
  203. same problem receiving files from PKZIP 2.04 users as well.
  204.  
  205.  
  206. Source code availability
  207. ------------------------
  208.  
  209. See the "Where" file included with the executable archive.
  210. See the "Index" file on the Internet ftp server described above
  211. for a list of what executable archives and formats are included.
  212.  
  213.  
  214. ========================================================================
  215.  
  216.  
  217. ****  PLEASE REPORT ALL BUGS TO <Zip-Bugs@WKUVX1.BITNET>  ****
  218.  
  219.  
  220.