home *** CD-ROM | disk | FTP | other *** search
/ ANews 2 / AnewsCD2.iso / Indispensables / Compression / UnZip_v5.32 / Docs / README.AMI < prev    next >
Text File  |  1999-10-04  |  10KB  |  203 lines
  1.  
  2. November 27, 1997
  3.  
  4. Amiga specific notes for UnZip 5.32 release of November 3, 1997
  5.  
  6. ------------------------------------------------------------------------
  7.  
  8. The Info-Zip UnZip 5.32 package consists of C source code that compiles
  9. on many platforms.  Some systems, such as Amiga, lack a bundled C
  10. language compiler, so we package and distribute supported executables
  11. for those.  This enables users who don't own compilers to have a
  12. reliable source for obtaining executables directly from the developers.
  13. This cuts down on the occurence of partial or haphazardly built
  14. distributions.
  15.  
  16. For more information about Info-Zip, and the enclosed utilities, please
  17. consult the README and doc files included in this archive.
  18.  
  19. To install the programs, copy the files UnZip, FUnZip, UnZipSFX, and
  20. MakeSFX to a utility command directory where you normally place add-on
  21. system commands.  This would be a directory normally found in your
  22. command path.  Type "path" in a CLI window for a display of which
  23. directories are in your path.  The simplest choice is to place them all
  24. in "C:", which is always in the path.
  25.  
  26. The official compiler for Info-Zip Amiga source used to be SAS/C version
  27. 6.51.  Any compiler revision from 6.2 and above is supported in theory.
  28. We do not support SAS/C 5.10b (too old) nor DICE (the programmer
  29. dissapeared).  But recent changes for the 5.2 and 5.3 releases of UnZip
  30. are largely untested with SAS/C, and so the current release has been
  31. compiled with Manx Aztec C 5.2b.  This compiler produces poorer code
  32. than SAS/C, but the use of assembly language "hot spots" in the source
  33. minimizes the difference in performance.  Recently a new SAS/C programmer
  34. has started working on UnZip, and we may soon be using that compiler again.
  35.  
  36. Consult the file, Where, for information on where to obtain source code
  37. if you would like a copy.  It's FREE!  If you have no access to any of
  38. the sources listed therein, send electronic mail to the address listed
  39. below, and be sure to state that you are working with the Amiga version
  40. (we support at least a dozen platforms).
  41.  
  42. These programs run only as CLI commands, but are compatible with
  43. Directory OPUS, SID, and IconX methods of execution.
  44.  
  45. New with UnZip 5.30 is 8 bit character set support.  When a file comes from
  46. an MS-DOS-like system, upper-ascii characters in filenames are converted,
  47. as nearly as possible, to the equivalent characters in the ISO character
  48. set that the Amiga uses.  For files originating on other systems, such as
  49. Unixes or the Windows 95/NT version of Zip, no conversion is needed.
  50.  
  51. -------------------------------------------------------------------------
  52.  
  53. SELF-EXTRACTING ARCHIVES:
  54.  
  55. Version 5.2 or higher of UnZip for Amiga adds the ability to create self-
  56. extracting Zip archives, which will recreate the archived files when the
  57. archive is executed as a program.  This UnZip package is delivered as such
  58. an archive in most cases.  These are created using the UnZipSFX program.
  59. On most platforms, all that is needed is to simply append the zip archive
  60. onto the UnZipSFX program, but on the Amiga this does not work.  Instead, a
  61. program called MakeSFX is used to combine the two.  The steps are to first
  62. create an archive using Info-ZIP's Zip (current version = 2.2), and then
  63. combine it with UnZipSFX using a MakeSFX command in this form:
  64.  
  65.     MakeSFX <program_name_to_create> <archive_to_convert> [UnZipSFX_name]
  66.  
  67. For example, if you want to convert an archive named Foo.zip into a self-
  68. extracting program named Foo.RunMe, you would use a command like this:
  69.  
  70.     MakeSFX Foo.RunMe Foo.zip sys:tools/UnZipSFX
  71.  
  72. If the program UnZipSFX is in your current directory or in C:, the last
  73. argument to MakeSFX can be ommitted (it defaults to "UnZipSFX" with no
  74. path).
  75.  
  76. Note: using the command "Zip -A" with an Amiga self-extracting archive may
  77. make the self-extracting program unrunnable with some versions of Zip.
  78. Official releases of Amiga Zip 2.1 and 2.2 ought to work okay, but Zip 2.0
  79. and some betas of 2.2 fail to handle Amiga self-extractors correctly, as
  80. do most versions of Zip for systems other than the Amiga.
  81.  
  82. The UnZipSFX program is itself compressed with PowerPacker 2.3b by Nico
  83. Francois, to minimize the extra size added to the archive.
  84.  
  85. -------------------------------------------------------------------------
  86.  
  87. AMIGA FILENOTES:
  88.  
  89. Normally, the comments that can be associated with Amiga files via the
  90. FileNote command are not stored in zip archives.  But the zip format
  91. allows a freeform comment to be associated with each file, and/or the
  92. archive as a whole.  The Amiga ports of Zip and UnZip have an option -N
  93. which allows filenotes to be stored as zipfile comments, and zipfile
  94. comments to be restored as filenotes.  If a Zip archive was created on
  95. an Amiga using the -N option, then using -N with UnZip will restore
  96. them.  Using it at other times may create filenotes that are somewhat
  97. meaningless, and possibly truncated if the original comment was longer
  98. than 79 characters, but this should have no negative consequences in
  99. most cases.
  100.  
  101. The -N option can be turned on permanently by setting the environment
  102. variable UNZIP with the following commands:
  103.  
  104.     SetEnv UNZIP -N
  105.     Copy ENV:UNZIP ENVARC:
  106.  
  107. Another option you will probably want to put into the UNZIP environment
  108. variable is -C, which makes it look up filenames in zip archives case
  109. insensitively.  Because zip archives can be created on Unix systems,
  110. there are cases where two files in an archive can have the same name
  111. except for letter case.  Because of this, the default behavior is that
  112. if you want to extract a particular file from a zip archive, with a
  113. command like this:
  114.  
  115.     UnZip foo.zip SomeFile
  116.  
  117. You have to type the name "SomeFile" in the correct letter case or
  118. nothing will be extracted.  The -C option allows you to type the name in
  119. any letter case, as you would with other Amiga commands.  So I would
  120. recommend this environment setting:
  121.  
  122.     SetEnv UNZIP -C -N
  123.  
  124. If you need to issue a particular UnZip command with the -C option
  125. turned off to match a file exactly, use --C in the command line.
  126. Similarly, --N can suppress the creation of filenotes if -N is present
  127. in the UNZIP environment variable.
  128.  
  129. -------------------------------------------------------------------------
  130.  
  131. TIMEZONES:
  132.  
  133. When extracting files that have been archived with a GMT timestamp, UnZip
  134. 5.32 now supports a full implementation of reading timezone information
  135. from the TZ environment variable, instead of the limited TZ support that
  136. was previously included.  If the variable TZ is not set, UnZip will use
  137. the timezone set in your locale preferences.  If it is your usual practice
  138. to manually change your system's clock twice a year, then you should
  139. specify a TZ setting that includes no daylight savings information.  For
  140. instance, in California you might use
  141.  
  142.     setenv TZ PST8
  143.     
  144. and not "PST8PDT".  Except that in summer, if your system's local time has
  145. been already adjusted to match local clocks, you should subtract 1 from
  146. the numeric part, e.g. "PST7".  This line is a command that might be
  147. included in your Startup-Sequence file.  Your timezone setting in the
  148. locale preferences should also be moved one zone east during the summer,
  149. in this case.  If it is correctly set in this way, you have no need for a
  150. separate TZ setting to make file dates come out correct.
  151.  
  152. If you leave your system clock set to standard time year round, then you
  153. should use a TZ variable that includes DST information.  In New York, this
  154. could be given as
  155.  
  156.     setenv TZ EST5EDT
  157.  
  158. and the "EDT" part will make sure that daylight savings corrections are
  159. applied correctly according to United States rules.  In Europe, where the
  160. rules are different, a string such as this one (for Germany) is needed:
  161.  
  162.     setenv TZ MET-1MEST,M3.5.0,M10.5.0/03
  163.  
  164. The full syntax of TZ specifications is given in the file timezone.doc,
  165. included in this archive.
  166.  
  167. -------------------------------------------------------------------------
  168.  
  169. REPORT ALL BUGS AND COMMENTS TO INFO-ZIP:   <Zip-Bugs@lists.wku.edu>
  170.  
  171. -------------------------------------------------------------------------
  172.  
  173. If you want to redistribute this archive, make sure that all the following
  174. files are included, as package