home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / packery / zip_v2.1 / non-encrypting / readme.ami next >
Text File  |  1977-12-31  |  12KB  |  290 lines
  1.  
  2. Info-Zip Zip 2.1 Executables for Amiga -- exportable compilation
  3. ========================================================================
  4.  
  5. Date:  May 5, 1996
  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 methods,
  18. and wild card inclusion and exclusion features.  It is compatible with
  19. PKZIP version 2.04g (but is not a PKZIP clone).  Info-Zip's Zip is free,
  20. and runs on a wide variety of Unix and proprietary system platforms.
  21.  
  22. A companion utility, Unzip, is also provided by Info-Zip, and is
  23. developed by other members of the group.  Chances are, you can obtain
  24. the most current version of Unzip from the same place you obtained this.
  25.  
  26. These utilities have also been referred to as "Portable Zip and Unzip".
  27.  
  28. See the file, "zip.doc" for a description of the included utilities and
  29. how to use them.
  30.  
  31.  
  32. Amiga Contacts
  33. --------------
  34.  
  35.   SAS/C porting:
  36.         John Bush <john.bush@east.sun.com>
  37.  
  38.   Manx Aztec C porting and assembly code:
  39.         Paul Kienitz <paul.kienitz@shelter.sf.ca.us>
  40.  
  41. Because recent revisions have not been tested with SAS/C, these
  42. executables have been compiled with Aztec C.  SAS/C generates much
  43. better code on average, but the use of assembly language "hot spots"
  44. helps to minimize the performance differences.
  45.  
  46.  
  47. Primary repositories
  48. --------------------
  49.  
  50.   1.  Internet:  ftp.uu.net:/pub/archiving/zip/AMIGA/
  51.                  Index          -- text file listing contents
  52.                  zip21x.zip     -- zip archive for those with unzip
  53.                  zip21x.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 -- zip21x.lha
  59.  
  60.       Excerpts from the Index and README.AMI files should be posted with
  61.       the file description in the BBS version.  PLEASE PRESERVE IT IF
  62.       UPLOADED ELSEWHERE.
  63.  
  64.  
  65. Archive contents
  66. ----------------
  67.  
  68. This archive should contain the following files:
  69.   README                      6760 ----rw-d 27-Apr-96 10:11:32
  70.   README.AMI                 12239 ----rw-d 05-May-96 23:12:30
  71.   zip.doc                    32815 ----rw-d 27-Apr-96 03:59:46
  72.   algorith.doc                3395 ----rw-d 01-Apr-96 09:10:34
  73.   history                    30154 ----rw-d 27-Apr-96 04:33:14
  74.   infozip.who                12920 ----rw-d 27-Apr-96 10:14:56
  75.   Where                      13973 ----rw-d 26-Apr-96 13:28:32
  76.   Zip                        69720 ----rwed 05-May-96 23:07:12
  77.   ZipNote                    36128 ----rwed 05-May-96 23:07:26
  78.   ZipSplit                   38308 ----rwed 05-May-96 23:07:44
  79.   Zip-LOWMEM                 74308 ----rwed 05-May-96 23:08:34
  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
  89. SAS/C version 6.3+ Manx Aztec version 5.2 compiler, you can obtain the
  90. source code from a non-USA based location where it was developed, and
  91. recompile with encryption enabled.  See the file, "Where" for
  92. information on obtaining sources.
  93.  
  94. The ZipCloak command is not included, because without encryption, it
  95. just reports that encryption is not supported.
  96.  
  97. If you are Internet accessible within the USA, but don't have access to
  98. one of the above mentioned compilers, I will email you a uuencoded copy
  99. of an executable with encryption enabled.  HOWEVER, to qualify for this,
  100. you must conform to the following.  I will ignore any request without
  101. 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.  
  115. Low memory operation
  116. --------------------
  117. This archive contains two different versions of Zip, in files named
  118. "Zip" and "Zip-LOWMEM".  Both compress files into zip archives and are
  119. used identically.  The difference is that Zip-LOWMEM only requires half
  120. as much memory to operate as Zip does.  If you get an error message
  121. saying that Zip cannot run because there is not enough memory (it
  122. requires at least 350K), try using Zip-LOWMEM instead.  Its compression
  123. performance is poorer than that of the real Zip, but is adequate for
  124. many purposes.
  125.  
  126.  
  127. Filenotes
  128. ---------
  129. Amiga filenotes are not normally stored in the zip archive.  But the zip
  130. format supports storing a one-line comment with each file, and Zip has
  131. an option "-N" which causes any Amiga files with attached filenotes to
  132. be stored with their filenote in this comment field.  If "-N" is used
  133. with the -c option, Zip will prompt for you to enter a comment line for
  134. each file that does not have a filenote.  The equivalent "-N" option of
  135. UnZip 5.2 will cause such comments to be attached to the expanded files
  136. as filenotes.  If desired the option "-N" can be specified in the
  137. environment variable ZIPOPT so that filenotes are always stored.
  138.  
  139.  
  140. Self-extracting archives
  141. ------------------------
  142. As documented in the UnZip 5.2 package, creation of self-extracting
  143. archives on the Amiga is more complex than on most other platforms.  One
  144. consequence of this is that Zip is currently not able to add or remove
  145. files to a self-extracting archive program with the "-A" option.  You
  146. must instead use the "-J" option to remove the self-extracting executable
  147. header, and then reconvert the archive to self-extracting form with the
  148. MakeSFX and UnZipSFX programs supplied with Amiga UnZip 5.2.  USE OF THE
  149. "-A" OPTION WILL CREATE AN EXECUTABLE THAT WON'T RUN.
  150.  
  151. MakeSFX can, if necessary, be compiled for other systems, so that Amiga
  152. self-extracting archives can be created on non-Amiga systems.  The
  153. source is included with the UnZip 5.2 source package, available as
  154. described below.
  155.  
  156.  
  157. Timezone information
  158. --------------------
  159. Zip 2.1 and UnZip 5.2 allow files to be stored with Unix-compatible
  160. timestamps specified in universal (Greenwich) time, so that the correct
  161. times will be restored when files are unzipped even when the unzipping
  162. is done in a different timezone from where the archive was created.
  163. Support for this information was not quite complete for the Amiga at the
  164. time of this release, so unless you recompile Zip with the symbol
  165. USE_EF_UX_TIME defined, such timestamps are not stored.  It is expected
  166. that a patch version of Zip should be released shortly which will store
  167. Unix timestamps in cases where the system it is run on has a "TZ"
  168. environment variable defined to specify what timezone it is in.
  169.  
  170.  
  171. Current directory specifier
  172. ---------------------------
  173. The Amiga uses an empty string ("") to specify the current directory,
  174. rather than the dot (".") used on many other systems.  This construct
  175. did not work with some compilations of Zip 2.0 but does work with Zip
  176. 2.1.  For instance, one can archive all files in the current directory
  177. and its subdirectories with a command such as this:
  178.  
  179.     Zip -r foo ""
  180.  
  181. To archive files in the current directory without including
  182. subdirectories, one would instead use wildcards, for instance:
  183.  
  184.     Zip foo *
  185.  
  186.  
  187. Wildcards
  188. ---------
  189. Wildcard selection is supported.  In addition to the basic regular
  190. expression interpretation as described in the section on PATTERN
  191. MATCHING in zip.doc, we have provided limited Amiga-style support.  The
  192. "#?"  combination is treated exactly like "*" which matches any number
  193. of any characters.  However, the "#" by itself is not supported except
  194. when in combination with the "?".  The Amiga alternation syntax (e.g.
  195. "(foo|bar|zot).*") is not supported at all.
  196.  
  197. One extension not described in zip.doc is the use of "^" in wildcard
  198. strings.  Specifically, "[^x]" will match any character other than "x".
  199. The "^" prefix in a bracketed string negates the expression which
  200. follows.  For example, the expression "#?.[^o]" will match all names
  201. ending with a single character filename extension, excluding those that
  202. end with ".o", and the expression "[^a-z]*" will match any file whose
  203. name starts with a non-alphabetic character.
  204.  
  205. The zip.doc file also talks about "escaping" wildcard specifiers to be
  206. passed to Zip, to prevent interpretation by the host shell.  This is not
  207. neccessary in the Amiga version.
  208.  
  209.  
  210. Archive testing
  211. ---------------
  212. The Zip archive testing option "-T" only works if UnZip is in your
  213. command path.  It works by simply running "UnZip -t" quietly.
  214.  
  215.  
  216. Path stripping
  217. --------------
  218. Directory paths can normally be stripped from stored files by specifying
  219. "zip -j".  However, even if "-j" is NOT specified, the Amiga version of
  220. Zip will strip volume names and leading slashes from stored names.
  221.  
  222.  
  223. Pipes
  224. -----
  225. Certain features can not be equally represented on all platforms.
  226. Some examples in the online manual page file (zip.doc) are subject to
  227. interpretation for the Amiga platform.  For example, true pipes are not
  228. supported on Amiga except with certain third-party command shells.  The
  229. Amiga PIPE: device is not capable of adequate support for Zip by any
  230. simple method.  Therefore, support is limited for pipe operations, and
  231. Amiga users should not expect that functionality to work until we
  232. specifically implement and announce support for it.
  233.  
  234.  
  235. Unix utilities
  236. --------------
  237. By default, the Amiga doesn't provide some utilities mentioned in
  238. zip.doc, such as tar and dd.  However, ports of the Gnu versions of
  239. these utilities are available from most internet servers that carry
  240. Amiga files, such as ftp.luth.se.
  241.  
  242.  
  243. Compatibility with UnZip and PKZIP
  244. ----------------------------------
  245. Files produced by this version of Zip can be un-archived with Info-Zip's
  246. unzip version 5.0p1 or higher.  The current Amiga release of UnZip is
  247. version 5.2, dated May 5, 1996, which is compatible.
  248.  
  249. It is also compatible with PKUNZIP 2.04g and above for DOS.
  250.  
  251. Two options are provided with Zip 2.1 to assist in conversion between
  252. DOS and Unix.  The "-l" and "-ll" options convert text files between LF
  253. and CR LF forms of delimiters.
  254.  
  255. In addition, the "-k" option is provided to remap filenames and
  256. attributes to MSDOS form.  Be careful using the "-k" option, especially
  257. if the transfer is bidirectional, since full filename information will
  258. be irreversibly converted to DOS naming conventions.  What this means is
  259. all filenames will be truncated to "8.3" format, and translated to upper
  260. case.  Characters not allowed in DOS will be filtered or translated, and
  261. the host-made-by field will be faked to indicate DOS.  Normally, it is
  262. best to name files in the first place according to the lowest common
  263. denominator where they will be used, rather than wrestle with such
  264. conversions.
  265.  
  266. If creating zip archives to be restored on a DOS machine that has
  267. PKUNZIP version 1.1, encourage your destination user to obtain the DOS
  268. version of Info-Zip unzip (UNZIP.EXE), or PKZIP version 2.04g or better.
  269. This will allow you to transfer archives using the best form of
  270. compression.  If you have to exchange files with earlier releases of
  271. PKUNZIP, then you must avoid the "deflation" method of compression (also
  272. known as type 8), by always specifying the "-0" option with Zip.  This
  273. performs a "store only" operation, in which files are simply copied into
  274. the archive with no actual compression.  Users of earlier releases of
  275. PKUNZIP have the same problem receiving files from PKZIP 2.04 users as
  276. well.
  277.  
  278.  
  279. Source code availability
  280. ------------------------
  281. See the "Where" file included with the executable archive.  See the
  282. "Index" file on the Internet ftp server described above for a list of
  283. what executable archives and formats are included.
  284.  
  285.  
  286. ========================================================================
  287.  
  288. ****  PLEASE REPORT ALL BUGS TO <Zip-Bugs@wkuvx1.wku.edu>  ****
  289.  
  290.