home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / UTILS / S3UZIP15 / READ.ME < prev    next >
Encoding:
Text File  |  1996-06-13  |  4.2 KB  |  117 lines
  1. s3uz150l.zip
  2.  
  3. This archive contains an EPOC binary for version 1.50 of Unzip
  4. for Psion Series 3, 3a, HC, MC400 and Workabout machines, plus
  5. some documentation.
  6.  
  7. This port is based on the Samuel H. Smith / Info-ZIP team source
  8. code, the home FTP site for which is ftp.uu.net:/pub/archiving/
  9.  
  10. The home FTP site for the EPOC port is:
  11.  
  12.   sunsite.doc.ic.ac.uk
  13.   /computing/systems/handhelds/psion/icdoc/utils/
  14.  
  15. where the current version is in files s3uzip15s.zip and
  16. s3uzip15l.zip - being the small and large variants, respectively
  17. (see below). Note that these filenames differ from the canonical
  18. ones listed below, due to the naming conventions for automatic
  19. update used at Imperial College. If downloading for further
  20. distribution, please rename the archives to s3uz150s.zip and
  21. s3uz150l.zip respectively, to conform with 8.3 format.
  22.  
  23. Version 1.50 incorporates some minor enhancements to the screen
  24. output, to better suit the wider 3a screen. A side-effect of
  25. these changes is that the output mis-displays under the
  26. DOS-hosted Series 3 emulator. This is a known problem with the
  27. emulator, and there is nothing to be done about it - without
  28. restricting 3a users to a 40-column output window.
  29.  
  30. Version 1.50 is available in two variants:
  31.  
  32.   1.50s -- the small variant, which handles version 2.x zip
  33.   archives only;
  34.  
  35.   1.50l -- the large variant, which handles all zip archive
  36.   versions, including the now obsolete version 1.x type.
  37.  
  38. The variant is indicated by a suffix letter in the name of the
  39. distribution zip file, after the version number:-
  40.  
  41.   s3uzNNNs.zip contains the small variant;
  42.   s3uzNNNl.zip contains the large variant.
  43.  
  44. The small variant is intended for use on a Series 3 classic,
  45. where memory is at a premium. The large variant is best used
  46. on machines with at least 512K.
  47.  
  48. Version 1.41 incorporated a workaround for a bug in Pkzip-made
  49. archives, whereby the Huffman distance tree may be incomplete in
  50. some circumstances. The program will note this by displaying
  51. '(incomplete d-tree)' after the file name, when extracting or
  52. testing an archive. Archives created with the generic version of
  53. Zip do not exhibit this problem.
  54.  
  55. Version 1.4 adds support for external applications that invoke
  56. UNZIP.IMG, specifying the destination directory to which files
  57. are to be extracted. See the enclosed file APPNOTES.TXT for more
  58. information.
  59.  
  60. Version 1.3 added support for unzipping from remote files across
  61. the serial link. This did not work in prior versions due to the
  62. failure of the CLIB stat() function across filesystems. See below
  63. for an example of remote unzipping.
  64.  
  65. UnZip requires considerable free memory to run, so its not
  66. suitable for unzipping other than small files to the internal
  67. drive.
  68.  
  69. To use interactively on Series 3/3a machines, you need version
  70. 1.1 of RUN.APP (included in this archive) as the front-end for
  71. the UNZIP.IMG file, or a similar shell.
  72.  
  73. See the enclosed file RUN.DOC for brief notes on installing and
  74. using the RUN utility. Quick quide: create a \RUN directory and
  75. copy UNZIP.IMG there; copy RUN.APP into an \APP directory, and
  76. install it on the system screen by keying Psion-I.
  77.  
  78. Here are some examples of the use of the 'Initial path' parameter
  79. with UnZip:
  80.  
  81.   Command line:  -l a:\transfer\myzip
  82.   Initial path:
  83.  
  84.   Command line:  -l myzip
  85.   Initial path:  a:\transfer
  86.  
  87. Where only a listing of the archive contents is requested, the
  88. two forms above are identical. Where an archive extraction is
  89. specified however, the 'Initial path' parameter specifies the
  90. directory to which the files archived should be extracted. For
  91. example:
  92.  
  93.   Command line:  a:\transfer\myzip
  94.   Initial path:  b:\
  95.  
  96. will cause the files in MYZIP.ZIP in the specified directory to
  97. be extracted to the root directory of drive B. Note that the full
  98. path name of the archive must be specified on the command line.
  99.  
  100. As of version 1.3, remote files can be unzipped using Unzip and
  101. Mclink or Slink. If Slink is used, it must be version 1.2 or
  102. later.
  103.  
  104.   Command line: rem::f:\download\newstuff
  105.   Initial path: a:\
  106.  
  107. will extract the remote zipfile on the PC to the SSD in drive A
  108. on the S3. This is the fastest way to move bulk data from PC to
  109. S3.
  110.  
  111. -------------
  112. David Palmer
  113. Edinburgh
  114. Scotland
  115. June, 1996
  116.  
  117.