home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / packery / zip_v2.1 / encrypting / readme.ami next >
Text File  |  1977-12-31  |  12KB  |  287 lines
  1.  
  2. Info-Zip Zip 2.1 Executables for Amiga -- NON-EXPORTABLE compilation
  3. ========================================================================
  4.  
  5. Date:  May 10, 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                 12337 ----rw-d 10-May-96 08:03:26
  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                        71796 ----rwed 10-May-96 07:13:42
  77.   ZipCloak                   39224 ----rwed 10-May-96 07:15:30
  78.   ZipSplit                   38512 ----rwed 10-May-96 07:15:00
  79.   ZipNote                    36340 ----rwed 10-May-96 07:14:44
  80.   Zip-LOWMEM                 76564 ----rwed 10-May-96 07:18:24
  81.  
  82.  
  83. NOTES
  84. ========================================================================
  85.  
  86. Encryption
  87. ----------
  88. This distributed executable supports encryption.  Unfortunately, legal
  89. restrictions exist on encrypting software in the United States, even
  90. software such as Zip for which source is publically available and which
  91. is far too crackable for high-security cryptographic uses.  What this
  92. means is that this version of Zip cannot be exported from the United
  93. States to any other country... though much of it came from outside the
  94. United States in the first place.  This archive probably should not be
  95. put up for public FTP on sites inside the USA.  Instead, it should be
  96. made available on sites in Europe and elsewhere.
  97.  
  98. One recent change since Zip 2.0 is that when using the encryption option
  99. "-e", the password must be entered twice for verification.  Previously
  100. this was the case when "-ee" was used.
  101.  
  102. The ZipCloak command is included.  It is left out of the non-encrypting
  103. distribution.
  104.  
  105.  
  106. Low memory operation
  107. --------------------
  108. This archive contains two different versions of Zip, in files named
  109. "Zip" and "Zip-LOWMEM".  Both compress files into zip archives and are
  110. used identically.  The difference is that Zip-LOWMEM only requires half
  111. as much memory to operate as Zip does.  If you get an error message
  112. saying that Zip cannot run because there is not enough memory (it
  113. requires at least 350K), try using Zip-LOWMEM instead.  Its compression
  114. performance is poorer than that of the real Zip, but is adequate for
  115. many purposes.  For instance, Zip-LOWMEM might be able to compress a
  116. large text file by 55% while the real Zip can achieve 65% (with option
  117. -9).  With smaller files or non-text files the difference is usually
  118. smaller.
  119.  
  120.  
  121. Filenotes
  122. ---------
  123. Amiga filenotes are not normally stored in the zip archive.  But the zip
  124. format supports storing a one-line comment with each file, and Zip has
  125. an option "-N" which causes any Amiga files with attached filenotes to
  126. be stored with their filenote in this comment field.  If "-N" is used
  127. with the -c option, Zip will prompt for you to enter a comment line for
  128. each file that does not have a filenote.  The equivalent "-N" option of
  129. UnZip 5.2 will cause such comments to be attached to the expanded files
  130. as filenotes.  If desired the option "-N" can be specified in the
  131. environment variable ZIPOPT so that filenotes are always stored.
  132.  
  133.  
  134. Self-extracting archives
  135. ------------------------
  136. As documented in the UnZip 5.2 package, creation of self-extracting
  137. archives on the Amiga is more complex than on most other platforms.  One
  138. consequence of this is that Zip is currently not able to add or remove
  139. files to a self-extracting archive program with the "-A" option.  You
  140. must instead use the "-J" option to remove the self-extracting executable
  141. header, and then reconvert the archive to self-extracting form with the
  142. MakeSFX and UnZipSFX programs supplied with Amiga UnZip 5.2.  USE OF THE
  143. "-A" OPTION ON AN AMIGA ARCHIVE WILL CREATE AN EXECUTABLE THAT WON'T RUN.
  144. The option can be used with Amiga Zip on self-extracting executables for
  145. other platforms.  This problem ought to be fixed in the next release of
  146. Zip.
  147.  
  148. MakeSFX can, if necessary, be compiled for other systems, so that Amiga
  149. self-extracting archives can be created on non-Amiga systems.  The
  150. source is included with the UnZip 5.2 source package, available as
  151. described below.
  152.  
  153.  
  154. Timezone information
  155. --------------------
  156. Zip 2.1 and UnZip 5.2 allow files to be stored with Unix-compatible
  157. timestamps specified in universal (Greenwich) time, so that the correct
  158. times will be restored when files are unzipped even when the unzipping
  159. is done in a different timezone from where the archive was created.
  160. Support for this information was not quite complete for the Amiga at the
  161. time of this release, so unless you recompile Zip with the symbol
  162. USE_EF_UX_TIME defined, such timestamps are not stored.  It is expected
  163. that a patch version of Zip should be released shortly which will store
  164. Unix timestamps in cases where the system it is run on has a "TZ"
  165. environment variable defined to specify what timezone it is in.
  166.  
  167.  
  168. Current directory specifier
  169. ---------------------------
  170. The Amiga uses an empty string ("") to specify the current directory,
  171. rather than the dot (".") used on many other systems.  This construct
  172. did not work with some compilations of Zip 2.0 but does work with Zip
  173. 2.1.  For instance, one can archive all files in the current directory
  174. and its subdirectories with a command such as this:
  175.  
  176.     Zip -r foo ""
  177.  
  178. To archive files in the current directory without including
  179. subdirectories, one would instead use wildcards, for instance:
  180.  
  181.     Zip foo *
  182.  
  183.  
  184. Wildcards
  185. ---------
  186. Wildcard selection is supported.  In addition to the basic regular
  187. expression interpretation as described in the section on PATTERN
  188. MATCHING in zip.doc, we have provided limited Amiga-style support.  The
  189. "#?"  combination is treated exactly like "*" which matches any number
  190. of any characters.  However, the "#" by itself is not supported except
  191. when in combination with the "?".  The Amiga alternation syntax (e.g.
  192. "(foo|bar|zot).*") is not supported at all.
  193.  
  194. One extension not described in zip.doc is the use of "^" in wildcard
  195. strings.  Specifically, "[^x]" will match any character other than "x".
  196. The "^" prefix in a bracketed string negates the expression which
  197. follows.  For example, the expression "#?.[^o]" will match all names
  198. ending with a single character filename extension, excluding those that
  199. end with ".o", and the expression "[^a-z]*" will match any file whose
  200. name starts with a non-alphabetic character.
  201.  
  202. The zip.doc file also talks about "escaping" wildcard specifiers to be
  203. passed to Zip, to prevent interpretation by the host shell.  This is not
  204. neccessary in the Amiga version.
  205.  
  206.  
  207. Archive testing
  208. ---------------
  209. The Zip archive testing option "-T" only works if UnZip is in your
  210. command path.  It works by simply running "UnZip -t" quietly.
  211.  
  212.  
  213. Path stripping
  214. --------------
  215. Directory paths can normally be stripped from stored files by specifying
  216. "zip -j".  However, even if "-j" is NOT specified, the Amiga version of
  217. Zip will strip volume names and leading slashes from stored names.
  218.  
  219.  
  220. Pipes
  221. -----
  222. Certain features can not be equally represented on all platforms.
  223. Some examples in the online manual page file (zip.doc) are subject to
  224. interpretation for the Amiga platform.  For example, true pipes are not
  225. supported on Amiga except with certain third-party command shells.  The
  226. Amiga PIPE: device is not capable of adequate support for Zip by any
  227. simple method.  However, Zip's pipe-oriented features have been tested
  228. with WShell by William Hawes, and should probably work with other shells
  229. that support pipe syntax.
  230.  
  231.  
  232. Unix utilities
  233. --------------
  234. By default, the Amiga doesn't provide some utilities mentioned in
  235. zip.doc, such as tar and dd.  However, ports of the Gnu versions of
  236. these utilities are available from most internet servers that carry
  237. Amiga files, such as ftp.luth.se.
  238.  
  239.  
  240. Compatibility with UnZip and PKZIP
  241. ----------------------------------
  242. Files produced by this version of Zip can be un-archived with Info-Zip's
  243. unzip version 5.0p1 or higher.  The current Amiga release of UnZip is
  244. version 5.2, dated May 5, 1996, which is compatible.
  245.  
  246. It is also compatible with PKUNZIP 2.04g and above for DOS.
  247.  
  248. Two options are provided with Zip 2.1 to assist in conversion between
  249. DOS and Unix.  The "-l" and "-ll" options convert text files between LF
  250. and CR LF forms of delimiters.
  251.  
  252. In addition, the "-k" option is provided to remap filenames and
  253. attributes to MSDOS form.  Be careful using the "-k" option, especially
  254. if the transfer is bidirectional, since full filename information will
  255. be irreversibly converted to DOS naming conventions.  What this means is
  256. all filenames will be truncated to "8.3" format, and translated to upper
  257. case.  Characters not allowed in DOS will be filtered or translated, and
  258. the host-made-by field will be faked to indicate DOS.  Normally, it is
  259. best to name files in the first place according to the lowest common
  260. denominator where they will be used, rather than wrestle with such
  261. conversions.
  262.  
  263. If creating zip archives to be restored on a DOS machine that has
  264. PKUNZIP version 1.1, encourage your destination user to obtain the DOS
  265. version of Info-Zip unzip (UNZIP.EXE), or PKZIP version 2.04g or better.
  266. This will allow you to transfer archives using the best form of
  267. compression.  If you have to exchange files with earlier releases of
  268. PKUNZIP, then you must avoid the "deflation" method of compression (also
  269. known as type 8), by always specifying the "-0" option with Zip.  This
  270. performs a "store only" operation, in which files are simply copied into
  271. the archive with no actual compression.  Users of earlier releases of
  272. PKUNZIP have the same problem receiving files from PKZIP 2.04 users as
  273. well.
  274.  
  275.  
  276. Source code availability
  277. ------------------------
  278. See the "Where" file included with the executable archive.  See the
  279. "Index" file on the Internet ftp server described above for a list of
  280. what executable archives and formats are included.
  281.  
  282.  
  283. ========================================================================
  284.  
  285. ****  PLEASE REPORT ALL BUGS TO <Zip-Bugs@wkuvx1.wku.edu>  ****
  286.  
  287.