home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / compress / pkazip11.lha / readme < prev    next >
Text File  |  1990-01-02  |  11KB  |  253 lines
  1.                     PKAZip, the Amiga ZIP tool!
  2.                     ---------------------------
  3.  
  4. PKAZip is the PKWare ZIP tool for the Amiga.  PKWare's MS-DOS
  5. product line includes:
  6.  
  7.      PKZIP     - The FAST data compressor!
  8.      PKUNZIP   - The FAST data decompressor!
  9.      PKZFIND   - A tool to locate files in directories or ZIP files!
  10.      STUPENDOS - A directory utility which provides access to MS-DOS
  11.                  files as well as ZIP files!
  12.  
  13. PKAZip is all of these tools and more!  It provides the Amiga user
  14. with a fully-Intuitionized tool written specifically for the Amiga.
  15. PKAZip provides COMPLETE support for the Amiga's file system while
  16. retaining compatibility with PKWare's PKZIP and PKUNZIP tools.
  17. PKAZip provides functions to create, examine, extract, test, modify,
  18. display and print files which are in the ZIP compressed format.
  19. PKAZip provides additional functions which support ZIP creation and
  20. extraction.  It provides full support for recursive copy and delete
  21. to allow you to copy or delete any or all files in one or more
  22. directories and subdirectories.  PKAZip will create directories as
  23. needed to support the copy operation and ZIP file creation.
  24.  
  25. PKAZip makes compressed file catalogs easier to use by allowing
  26. file comments to be added to each file in the ZIP catalog.  Comments
  27. may be added or modified anytime, without the need to extract files
  28. from the ZIP file.  PKAZip offers more convenience by providing you
  29. with a tool to change file protection bits and rename files while
  30. they are still in the compressed state.  In addition, PKAZip allows
  31. you to attach a 255 character ZIP comment to the ZIP file to help
  32. identify the ZIP file in the future.
  33.  
  34. PKAZip offers an inovative and powerful search feature that can
  35. locate those hard to find files!  Search allows you to locate files
  36. by name or by file comment in any directory and most importantly,
  37. INSIDE compressed ZIP files!  Now you have the power and convenience
  38. you need to quickly find those files.
  39.  
  40. Above all, PKAZip does all of this much faster than competitive data
  41. compression/extraction tools while increasing data reliability with
  42. the use of 32-bit Cyclic Redundancy Check (CRC).  The full-Intuition
  43. interface provides easy to use buttons and menus to get you started
  44. quickly!  Even the experienced ZIP user will find it easy to create
  45. and maintain large collections of ZIP files on the Amiga.  
  46.  
  47.  
  48.                         How to get started
  49.                         ------------------
  50.  
  51. To use PKAZip from the Command Line Interface, copy PKAZip to a
  52. directory which is in your path. Set the Amiga's stack to at least
  53. 40000 bytes.  From the command line prompt, type PKAZip followed by
  54. the Return key to launch the program.
  55.  
  56. To use PKAZip from the WorkBench, place the PKZIP program and icon
  57. in any WorkBench drawer by dragging it into that drawer.  Double
  58. click on the PKAZip icon to launch PKAZip.
  59.  
  60. Once PKAZip is started, you will get a message that PKAZip can not
  61. find ZIP.PREFS and ZIP.LICENSE.  This is normal at this point.  Click
  62. on the OK box in these messages.  After a slight delay, PKAZip is ready
  63. for use.  Use PKAZip to copy ZIP.HELP, ZIP.LICENSE and ZIP.PREFS to the
  64. S: directory:  
  65.  
  66.   -  Enter the drive and directory where these files exist into the 
  67.      source string box in the lower left corner of PKAZip's screen.
  68.  
  69.   -  Enter S: into the destination string box in the lower right
  70.      corner of the screen.
  71.  
  72.   -  Select ZIP.HELP, ZIP.LICENSE and ZIP.PREFS by clicking on each
  73.      filename in the central files box.
  74.  
  75.   -  Click the COPY button which is below the central files box.  This
  76.      should copy the files into the S: directory.
  77.  
  78. At this point, you can exit PKAZip and restart the program to insure
  79. that PKAZip is able to find the files you just copied into the S: 
  80. directory.
  81.  
  82. Under normal use, after you start PKAZip, you can either click in the
  83. main files window (the box in the center of the screen), type in a
  84. drive and directory name in the left directory box or use the DEVICE
  85. button to select any physical or logical drive in your system.
  86.  
  87. Please examine the license and help files by using the LICENSE and HELP
  88. buttons on PKAZip's main screen.  These files contain additional and
  89. useful information about PKAZip.  You must have zip.license in the S:
  90. directory to operate PKAZip.
  91.  
  92.  
  93.                          Important Note
  94.                          --------------
  95. If you have only 512K of memory, you must assign PKTEMP: to one of 
  96. your disk drives.  This forces PKAZip to create temporary ZIP files
  97. on the disk drive and not in memory.  If you have 1 Meg or more of
  98. memory, you can assign PKTEMP: to RAM: and get a significant increase
  99. in performance during ZIP creation or modification.
  100.  
  101. If you do not assign PKTEMP:, PKAZip will use T: as its temporary
  102. storage location.
  103.  
  104.  
  105.                          Zipping Files
  106.                          -------------
  107. Creating ZIP files is very easy with PKAZip!  As an example of how easy
  108. it is to create a ZIP file for distribution over a BBS, assume there
  109. are five files you need to compress.  Also, you want to save the files
  110. and their pathnames so the person that receives your ZIP file will be
  111. able to extract the files to the proper directories. The file you wish
  112. to create will be named DIST.ZIP and you want to create the ZIP file
  113. on your RAM disk to speed things up.  Finally, you want to add a ZIP
  114. comment to the ZIP file so everyone will know you created it.
  115.  
  116. Here is the list of files you want to compress:
  117.  
  118.      dh0:s/script_file.txt
  119.      dh0:c/my_command
  120.      dh0:c/second_command
  121.      dh0:l/my_handler
  122.      dh0:libs/my_library
  123.  
  124.      
  125. Create the ZIP file by following these steps:
  126.  
  127.   -  Select LONG PATH NAMES from the COMPRESS menu to force PKAZip
  128.      to store each filename with its complete path.
  129.  
  130.   -  Type RAM:DIST.ZIP into the destination string box in the lower
  131.      right corner of PKAZip's screen and press the Return key.
  132.  
  133.   -  Type dh0:s into the source string box in the lower left corner of
  134.      PKAZip's screen and press the Return key.  This should display
  135.      the list of files in the dh0:s directory.
  136.  
  137.   -  Scroll the file list until script_file.txt is visible and click
  138.      once on the line containing script_file.txt to select this file.
  139.  
  140.   -  Press the COMPRESS button below the files list to activate the
  141.      compression process.  PKAZip will automatically decide if the
  142.      compression technique should be imploding (best compression -
  143.      most time), shinking (good compression - very fast) or storing
  144.      (no compression).  You can override PKAZip by using the FORCE
  145.      SHRINKING option from the COMPRESS menu.
  146.  
  147.      PKAZip should create the ZIP file on the RAM: drive and add
  148.      a file with s/script_file.txt as the filename.
  149.  
  150.   -  Change the source string box in the lower left corner to dh0:c.
  151.  
  152.   -  Select both my_command and second_command using the mouse.
  153.  
  154.   -  Press the ZIP button below the files list to add these two
  155.      files to the DIST.ZIP file on the RAM: drive.  These files will
  156.      be added as c/my_command and c/second_command respectively.
  157.  
  158.   -  Change the source string box to dh0:l and dh0:libs to add
  159.      the renaming two files to the ZIP file.
  160.  
  161.   -  Change the source string box to RAM: to display the list of
  162.      files on RAM: which should include DIST.ZIP.  Select DIST.ZIP
  163.      and press the INFO button below the files list.  This should
  164.      display the File Info Window which contains a string box which
  165.      allows you to enter the name of your BBS.  This string box will
  166.      allow you to enter a 255 character ZIP comment.
  167.  
  168.      Once you have entered your comment, press the SAVE button in
  169.      the File Info window to save your comment with the ZIP file.
  170.  
  171.   -  You are finished!  The ZIP file is ready to be uploaded to a 
  172.      BBS.
  173.  
  174.                          Extracting Files
  175.                          ----------------
  176.  
  177. Assume you just downloaded the DIST.ZIP file from your local bulletin
  178. board.  Also assume you downloaded it to your RAM: drive.  You can
  179. examine the ZIP file to determine if it has a ZIP comment attached to
  180. it by running PKAZip and entering RAM: into the source string box.
  181.  
  182. Select the file and press the INFO button below the files list.  This
  183. will display the File Info window which contains the ZIP comment if any.
  184. Press the CANCEL or ABORT buttons to exit the File Info window and
  185. return to the files list.
  186.  
  187. You can view the contents of the ZIP file by simply changing PKAZip's
  188. source string box to RAM: and double clicking on the DIST.ZIP filename.
  189. This will display a sorted list of files contained in the ZIP file.
  190. You can alternate between viewing this list with size information, date
  191. and filename or file comment and filename by repeatedly pressing the
  192. COMMENT button below the files list.
  193.  
  194. You can display any files in the ZIP file by selecting them and pressing
  195. the DISPLAY button.  This allows you to read the information that is
  196. usually posted with ZIP files to help you use the programs.
  197.  
  198. As an example, assume you have examined the ZIP file and you want to
  199. extract the files to your harddrive named dh0:.
  200.  
  201.   -  Type dh0: into the destination string box and press the Return
  202.      key.  This tells PKAZip where to put the files during extraction.
  203.  
  204.   -  Assuming you are still looking at the list of files contained
  205.      in the ZIP file, you may simply select those files you wish to
  206.      extract.
  207.  
  208.   -  Check the Extract Menu to make sure USE PATHNAMES is checked. 
  209.      This will insure that PKAZip will use any path information stored
  210.      with the filename.  PKAZip will prompt you if it needs to create
  211.      any directories during the extraction process.
  212.  
  213.   -  Press the UNZIP button to begin the extraction process.  Any
  214.      selected file will be extracted to the destination drive and
  215.      placed in the correct directory for you!
  216.  
  217.  
  218.                            Final Note
  219.                            ----------
  220.  
  221. The zip.help file contains detailed information on the operation of
  222. PKAZip.  To get the most out of this program, please read this file
  223. before using PKAZip.
  224.  
  225.  
  226.                        Planned Improvements
  227.                        --------------------
  228.  
  229. - Arexx interface or command line version
  230. - Ability to extract Reduced files
  231. - Encryption
  232. - Authenticity-Verification
  233.  
  234.  
  235.                           Acknowledgments
  236.                           ----------------
  237.  
  238. I would like to thank my family for their support and encouragement
  239. during development of PKAZip.  It was a long and difficult journey!
  240.  
  241. I would like to thank Bob Ballard for his support and encouragement
  242. as well as some great ideas.  I would also like to thank Bob, Harvey
  243. Harbicht and Mike Shawaluk for their testing and suggestions.
  244.  
  245. Also, I would like to thank all of the others that have commented on
  246. what they would like PKAZIP to be.  I encourage everyone to support
  247. PKWare's efforts to provide the Amiga community with a powerful data
  248. compression tool.  This support will encourage PKWare to release
  249. additional tools for the Amiga.
  250.  
  251. Dennis Hoffman
  252. Safe Harbor BBS (414) 544-6567
  253.