home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 2 / MECOMP-CD-II.iso / amiga / tools / packer / zip_v2.2 / docs / readme.ami < prev    next >
Encoding:
Text File  |  1997-11-28  |  11.9 KB  |  275 lines
  1.  
  2. Info-Zip Zip 2.2 Executables for Amiga -- NON-EXPORTABLE compilation
  3. ========================================================================
  4.  
  5. Date:  November 27, 1997
  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.   Original SAS/C porting:
  36.         John Bush <john.bush@east.sun.com>
  37.  
  38.   Manx Aztec C porting and assembly code:
  39.         Paul Kienitz <kie@pacbell.net>
  40.     
  41.   New SAS/C support and timezone enhancements:
  42.         Haidinger Walter <walthaid@jupiter.ict.tuwien.ac.at>
  43.                       or <e9225662@student.tuwien.ac.at>
  44.  
  45. Because recent revisions have not been very well tested with SAS/C, these
  46. executables have been compiled with Aztec C.  SAS/C generates much better
  47. code on average, but the use of assembly language "hot spots" helps to
  48. minimize the performance differences.
  49.  
  50.  
  51. Archive contents
  52. ----------------
  53.  
  54. This archive should contain the following files:
  55.   ZipSplit                   40424 ----rwed 27-Nov-97 23:42:25
  56.   ZipNote                    38184 ----rwed 27-Nov-97 23:42:09
  57.   Zip                        79176 ----rwed 27-Nov-97 23:41:19
  58.   Zip-LOWMEM                 79212 ----rwed 27-Nov-97 23:45:14
  59.   README.AMI                 12172 ----rw-d 27-Nov-97 23:51:11
  60.   timezone.doc                4343 ----rw-d 27-Nov-97 15:21:22
  61.   WHERE                      16717 ----rw-d 02-Nov-97 21:40:36
  62.   WHATSNEW                     765 ----rw-d 15-Oct-97 11:27:43
  63.   README                      6720 ----rw-d 03-Nov-97 22:48:39
  64.   MANUAL                     35344 ----rw-d 15-Oct-97 12:32:30
  65.  
  66.  
  67. NOTES
  68. ========================================================================
  69.  
  70. Encryption
  71. ----------
  72. This distributed executable DOES NOT support encryption, and does not include
  73. the ZipCloak tool.  Unfortunately, legal restrictions exist on encrypting
  74. software in the United States, even software such as Zip for which source is
  75. publically available and which is far too crackable for high-security
  76. cryptographic uses.  What this means is that the encrypting version of Zip
  77. generally cannot be put up for public FTP on sites inside the USA.  Instead,
  78. it is made available on sites in Europe and elsewhere; see the file "WHERE"
  79. for details.
  80.  
  81.  
  82. Low memory operation
  83. --------------------
  84. This archive contains two different versions of Zip, in files named
  85. "Zip" and "Zip-LOWMEM".  Both compress files into zip archives and are
  86. used identically.  The difference is that Zip-LOWMEM only requires half
  87. as much memory to operate as Zip does.  If you get an error message
  88. saying that Zip cannot run because there is not enough memory (it
  89. requires at least 350K free), try using Zip-LOWMEM instead.  Its
  90. compression performance is poorer than that of the real Zip, but is
  91. adequate for many purposes.  For instance, Zip-LOWMEM might be able to
  92. compress a large text file by 55% while the real Zip can achieve 65% (with
  93. option -9).  With smaller files or non-text files the difference is
  94. usually smaller.
  95.  
  96.  
  97. Filenotes
  98. ---------
  99. Amiga filenotes are not normally stored in the zip archive.  But the zip
  100. format supports storing a one-line comment with each file, and Zip has
  101. an option "-N" which causes any Amiga files with attached filenotes to
  102. be stored with their filenote in this comment field.  If "-N" is used
  103. with the -c option, Zip will prompt for you to enter a comment line for
  104. each file that does not have a filenote.  The equivalent "-N" option of
  105. UnZip 5.2 will cause such comments to be attached to the expanded files
  106. as filenotes.  If desired the option "-N" can be specified in the
  107. environment variable ZIPOPT so that filenotes are always stored.
  108.  
  109.  
  110. Self-extracting archives
  111. ------------------------
  112. As documented in the UnZip 5.2 package, creation of self-extracting
  113. archives on the Amiga is more complex than on most other platforms.  One
  114. consequence of this is that most ports of Zip other than the Amiga one are
  115. currently not able to add or remove files to a self-extracting archive
  116. program with the "-A" option.  If you are working with a version of Zip
  117. for some system other than Amiga, or if you have an old version of Amiga
  118. Zip, you must instead use the "-J" option to remove the self-extracting
  119. executable header, and then reconvert the archive to self-extracting form
  120. with the MakeSFX and UnZipSFX programs supplied with Amiga UnZip 5.2, or
  121. you will get a self-extracting program that won't run.
  122.  
  123. MakeSFX can, if necessary, be compiled for other systems, so that Amiga
  124. self-extracting archives can be created on non-Amiga systems.  The
  125. source is included with the UnZip 5.2 source package, available as
  126. described in the "WHERE" file included in this archive.
  127.  
  128.  
  129. Timezone information
  130. --------------------
  131. Zip 2.1 and UnZip 5.2 allow files to be stored with Unix-compatible
  132. timestamps specified in universal (Greenwich) time, so that the correct
  133. times will be restored when files are unzipped even when the unzipping
  134. is done in a different timezone from where the archive was created.  A
  135. change since Zip 2.1 is that Zip now supports the complete syntax for
  136. specifying alternate daylight savings time rules in the TZ environment
  137. variable, as documented in the file "timezone.doc".  Note: if your normal
  138. practice is to manually set your Amiga's clock one hour forward in spring
  139. and back in the fall to match local time, then you should NOT use a
  140. timezone specification that includes daylight savings time.  Instead use a
  141. specification such as (for California):
  142.  
  143.     setenv TZ PST8
  144.  
  145. and not "PST8PDT".  And you should set the number in the TZ string one
  146. lower in the summer, changing the definition when you change the clock,
  147. for instance "PST7".  In Germany you would change it from "MET-1" to
  148. "MET-2".  Alternatively, you can just use the locale preferences setting
  149. and leave TZ unset, moving it one zone to the east when you set your clock
  150. forward for summer.  If you use a full TZ specification that includes
  151. daylight savings time, it will only give accurate results if you leave
  152. your Amiga's system clock set to standard time all year round.  Naturally,
  153. none of this is important if you are not concerned with making sure that
  154. file times are exactly correct.  This may be important if it is necessary
  155. to, for instance, be sure which of two versions is newer by half an hour,
  156. but for most purposes errors of a few hours are nothing to worry about.
  157.  
  158.  
  159. Current directory specifier
  160. ---------------------------
  161. The Amiga uses an empty quoted string ("") to specify the current
  162. directory, rather than the dot (".") used on many other systems.  This
  163. construct did not work with some compilations of Zip 2.0 but does work
  164. with Zip 2.1 and up.  For instance, one can archive all files in the
  165. current directory and its subdirectories with a command such as this:
  166.  
  167.     Zip -r foo ""
  168.  
  169. To archive files in the current directory without including
  170. subdirectories, one would instead use wildcards, for instance:
  171.  
  172.     Zip foo *
  173.  
  174.  
  175. Wildcards
  176. ---------
  177. Wildcard selection is supported.  In addition to the basic regular
  178. expression interpretation as described in the section on PATTERN
  179. MATCHING in zip.doc, we have provided limited Amiga-style support.  The
  180. "#?"  combination is treated exactly like "*" which matches any number
  181. of any characters.  However, the "#" by itself is not supported except
  182. when in combination with the "?".  The Amiga alternation syntax (e.g.
  183. "(foo|bar|zot).*") is not supported at all.
  184.  
  185. One extension not described in the MANUAL file is the use of "^" in
  186. wildcard strings.  Specifically, "[^x]" will match any character other
  187. than "x".  The "^" prefix in a bracketed string negates the expression
  188. which follows.  For example, the expression "#?.[^o]" will match all names
  189. ending with a single character filename extension, excluding those that
  190. end with ".o", and the expression "[^a-z]*" will match any file whose name
  191. starts with a non-alphabetic character.  The character "!" can be used
  192. instead of "^".
  193.  
  194. The zip.doc file also talks about "escaping" wildcard specifiers to be
  195. passed to Zip, to prevent interpretation by the host shell.  This is not
  196. neccessary in the Amiga version, except possibly when using a Unix-like
  197. replacement command shell.
  198.  
  199.  
  200. Archive testing
  201. ---------------
  202. The Zip archive testing option "-T" only works if UnZip is in your
  203. command path.  It works by simply running "UnZip -t" quietly.
  204.  
  205.  
  206. Path stripping
  207. --------------
  208. Directory paths can normally be stripped from stored files by specifying
  209. "zip -j".  However, even if "-j" is not specified, the Amiga version of
  210. Zip will strip volume names and leading slashes from stored names.
  211.  
  212.  
  213. Pipes
  214. -----
  215. Certain features can not be equally represented on all platforms.
  216. Some examples in the online manual page file (zip.doc) are subject to
  217. interpretation for the Amiga platform.  For example, true pipes are not
  218. supported on Amiga except with certain third-party command shells.  The
  219. Amiga PIPE: device is not capable of adequate support for Zip by any
  220. simple method.  However, Zip's pipe-oriented features have been tested
  221. with WShell by William Hawes, and should probably work with other shells
  222. that support pipe syntax.
  223.  
  224.  
  225. Unix utilities
  226. --------------
  227. By default, the Amiga doesn't provide some utilities mentioned in
  228. zip.doc, such as tar and dd.  However, ports of the Gnu versions of
  229. these utilities are available from various Aminet FTP servers, such as
  230. ftp.netnet.net.
  231.  
  232.  
  233. Compatibility with UnZip and PKZIP
  234. ----------------------------------
  235. Files produced by this version of Zip can be un-archived with Info-Zip's
  236. unzip version 5.0p1 or higher.  The current Amiga release of UnZip is
  237. version 5.2, dated May 5, 1996, which is compatible.
  238.  
  239. It is also compatible with PKUNZIP 2.04g and above for DOS.
  240.  
  241. Two options are provided with Zip 2.2 to assist in conversion between
  242. DOS and Unix.  The "-l" and "-ll" options convert text files between LF
  243. and CR LF forms of delimiters.
  244.  
  245. In addition, the "-k" option is provided to remap filenames and
  246. attributes to MSDOS form.  Be careful using the "-k" option, especially
  247. if the transfer is bidirectional, since full filename information will
  248. be irreversibly converted to DOS naming conventions.  What this means is
  249. all filenames will be truncated to "8.3" format, and translated to upper
  250. case.  Characters not allowed in DOS will be filtered or translated, and
  251. the host-made-by field will be faked to indicate DOS.  Normally, it is
  252. best to name files in the first place according to the lowest common
  253. denominator where they will be used, rather than wrestle with such
  254. conversions.
  255.  
  256. If you have to exchange files with earlier releases of PKUNZIP such as
  257. v1.1, then you must avoid the "deflation" method of compression (also
  258. known as type 8), by always specifying the "-0" option with Zip.  This
  259. performs a "store only" operation, in which files are simply copied into
  260. the archive with no actual compression.  Users of earlier releases of
  261. PKUNZIP have the same problem receiving files from PKZIP 2.04 users as
  262. well.
  263.  
  264.  
  265. Source code availability
  266. ------------------------
  267. See the "WHERE" file included with the executable archive for pointers to
  268. source archives, as well as executables for other platforms.
  269.  
  270.  
  271. ========================================================================
  272.  
  273. ****  PLEASE REPORT ALL BUGS TO <Zip-Bugs@lists.wku.edu>  ****
  274.  
  275.