home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / developm / source / unzip101.cpt / unzip1.01source / UNZIP.DOC < prev    next >
Encoding:
Text File  |  1989-08-21  |  4.5 KB  |  128 lines
  1.   
  2.                                    ST_UnZip
  3.   
  4.                            Version 1.2, 03-30-89
  5.   
  6.                            Zipfile Extract Utility
  7.   
  8.           Copyright (C) 1989 Samuel H. Smith;  ALL RIGHTS RESERVED
  9.             
  10.             Atari ST Adaptation (inline crc routine, and executable)
  11.             (C) 1989 Darin Wayrynen
  12.   
  13. 'UnZip' is a small Zipfile extract utility.   It is written to be as
  14. small and portable as possible -- ideal as a starting point for handling
  15. .ZIP files in non-IBM/Atari ST environments.
  16.  
  17. Source code is provided in C.  If you port this program to a 
  18. non-IBM/Atari ST system, we would appreciate a copy of the ported 
  19. source and exec files.
  20.  
  21.  
  22. Usage
  23. -----
  24. desktop:
  25.    drive:\path\filename[.zip]
  26.    
  27. shell:
  28.    unzip drive:\path\filename[.zip]
  29.    
  30. Atari ST note: Unzip will place unzipped files into the current directory
  31.  (usually into the folder you ran unzip from).  To run from the desktop,
  32.  rename unzip.prg to unzip.ttp and enter zip file name into the Tos Takes
  33.  Parameters box after clicking on unzip.ttp.  It would be best to create a
  34.  new directory on your hard drive, or a blank floppy disk, and then copy
  35.  unzip.ttp to it before running the program, otherwise the unziped files 
  36.  will be mixed in with all the files in the current directory.
  37.  When running it from a shell, you can change your current directory to a
  38.  blank directory, and then specify the full pathname for unzip and the zip
  39.  file on the command line (or just 'unzip drive:\path\filename[.zip] if
  40.  your shell support directory hashing like Gulam does).
  41.  
  42.  If any interest is shown in the program, a gem based shell will be written
  43.  to support unzip. 
  44.  
  45.  
  46. Revision history
  47. ----------------
  48.  
  49. 3-3-89 (Samuel)
  50.    Initial alpha test release.
  51.  
  52. 3-5-89 (Samuel)
  53.    First fully operational release.  Does not implement CRC verification,
  54.    but should correctly unzip all compression methods.
  55.  
  56. 3-6-89 (Samuel)
  57.    Corrected end-of-file detection in both shrink and reduce expanders.
  58.    Resulting files should now always have the correct size.  Added ".ZIP"
  59.    default to unzip.c to match calling conventions of unz.pas.
  60.  
  61. 3-8-89 (Samuel)
  62.    Moved machine and operating-system specific code to a block starting
  63.    around line 180.  Added code to swap bytes on host machines that
  64.    store the high order bytes in lower address locations than the low
  65.    order bytes.
  66.  
  67. 3-15-89 (Samuel)
  68.    Added CRC checking in UNZIP.C.  Speeded operation by about 150%.
  69.  
  70.    I'm spending my time on the C version now and don't plan to do any
  71.    further work on the pascal.  If you're using the pascal version
  72.    please contact me.
  73.  
  74. 3-30-89 (Darin)
  75.    Custom 68000 assembly routine written for 32 bit CRC calculation,
  76.    enlarged buffer support, and slight changes made to improve 
  77.    execution speed on the Atari ST.  I'll be spending my time re-writing
  78.    most of the time consuming routines into assembly, and making equivelent
  79.    changes to the ST source as Samuel updates the IBM source.
  80.    
  81. LICENSE
  82. =======
  83.  
  84. You may copy and distribute this program freely, provided that:
  85.     1)   No fee is charged for such copying and distribution, and
  86.     2)   It is distributed ONLY in its original, unmodified state.
  87.  
  88. If you wish to distribute a modified version of this program, you MUST
  89. include the source code.
  90.  
  91. 68000 assembly code for CRC calculations cannot be used in any program
  92. where source is not included.  Contact either Samuel or Darin on the
  93. Tool Shop bbs if interested in commercial applications using the 
  94. assembly code.
  95.  
  96. If you modify this program, we would appreciate a copy of the new source
  97. code.  Samuel is holding the copyright on the source code, so please don't
  98. delete his name from the program files or from the documentation.
  99.  
  100.  
  101. SUPPORT
  102. =======
  103.  
  104. I work very hard to produce a software package of the highest quality
  105. and functionality.  I try to look into all reported bugs, and will
  106. generally fix reported problems within a few days.
  107.  
  108. IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST
  109. PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES
  110. ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY
  111. CLAIM BY ANY OTHER PARTY.
  112.  
  113. If you have any questions, bugs, or suggestions, please contact either
  114. of us at:
  115.  
  116.                            The Tool Shop BBS
  117.                        (602) 264-3969 (HST 9600)
  118.                        (602) 279-2673 (HAYES 9600)
  119.  
  120. The latest version is always available for downloading.
  121.  
  122. Enjoy!     Samuel H. Smith
  123.            - Author and Sysop of The Tool Shop.
  124.            Darin Wayrynen
  125.            - Author of NextGen Term, Gemspeed, and Bytefree.
  126.    
  127.  
  128.