home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / compress / zippy121.lzh / Zippy121.Doc < prev    next >
Text File  |  1990-01-02  |  16KB  |  356 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.            __________
  15.           /_________/\     _
  16.                    / /    / \
  17.                   / /     \_/
  18.                  / /        _      _____        _____
  19.                 / /        /|     /|___ \      /|___ \    /\      /\
  20.                / /        / |    / |   \ \    / |   \ \   \ \    / /
  21.               / /         | |    | |    \ \   | |    \ \   \ \  / /
  22.              / /          | |    | |    / /   | |    / /    \ \/ /
  23.             / /           | |    | |___/ /    | |___/ /      \/ /
  24.            / /_________   | /    | |____/     | |____/       / /
  25.            \/_________/   |/     | |          | |           / /
  26.                                  | |          | |  Version / / 1.21
  27.           An Amiga UnZip Utility | /          | /         / /
  28.                                  |/           |/          \/
  29.  
  30.                         Copyright © 1989 by David Godshall
  31.  
  32.  
  33.  
  34.  
  35.  
  36.      ___________
  37.       Legaleeze
  38.      ~~~~~~~~~~~
  39.      The program Zippy, the source to said program (not included), and the
  40.      documentation are Copyrighted by the author, David Godshall.
  41.      Permission is granted to individuals wishing to use the program in a
  42.      non-commercial setting for their own personal use.  Others must
  43.      contact the author and obtain permission in writing (see contribution
  44.      section at end of documentation) before using Zippy in a commercial
  45.      setting; the only exception to this being a "trial period", not to
  46.      exceed three weeks, during which you may use the program before
  47.      needing to register it.
  48.  
  49.      The author, David Godshall, can assume no responsibility for damage
  50.      caused or thought to have been caused, either directly or indirectly,
  51.      through use of the Zippy program.  This includes, but is not limited
  52.      to, loss of data, mechanical difficulties, insanity, and IBMitis.
  53.      Although I try to make the program as safe as possible/feasible, use
  54.      is strictly "at your own risk".
  55.  
  56.      ___________________
  57.       About The Program
  58.      ~~~~~~~~~~~~~~~~~~~
  59.      Zippy is a program designed to extract files from a .ZIP format
  60.      archive.  Even though there is currently no utility for the Amiga to
  61.      create ZIP archives, the ZIP format is such a flexible and powerful
  62.      format that it is not unusual to find BBSs with Amiga ZIP archives
  63.      (created using an IBM Zip program).  The advantages of ZIP over the
  64.      existing ARC standard is mainly that the ZIP format was designed not
  65.      only with MS-DOS computers in mind, but was created to work with just
  66.      about any computer.  Thus it does NOT limit the length of the
  67.      filename like ARC does!  That's the biggest advantage for us Amiga
  68.      users, but other advantages include the ability to store directory
  69.      structures (so when you unzip something, it will automatically create
  70.      the proper directories and put the files in them), better compression
  71.      techniques (ZIP files are often smaller than ARC files), the ability
  72.      to know what OS the file was zipped under so that when a text file is
  73.      unzipped the End-Of-Line characters can be fixed for you (i.e. MS-DOS
  74.      computers use both the CR and LF characters to indicate the end of a
  75.      line, whereas the Amiga uses only the LF character), the ability for
  76.      an archive to span multiple disks (mainly useful for disk backups and
  77.      stuff like that -- No ZIP program currently handles that possibility,
  78.      but it is definitely in the specs).  In fact, it appears that PKWare
  79.      (the inventors of the ZIP format) had the Amiga in mind when they
  80.      created the ZIP format, and are working (or have hired someone to
  81.      work on) Amiga versions of the PKZIP and PKUNZIP programs, which
  82.      would be the "official", full-featured versions.  Since they have not
  83.      been released yet (as of the day I am writing this), a couple of
  84.      UnZip programs have surfaced for the Amiga already.  Here is another
  85.      one.
  86.  
  87.      But!  This is not *JUST* another UnZip program.  This is the richest,
  88.      most featured unzip program I've seen for the Amiga so far.  It can
  89.      take advantage of most of the features of the ZIP format and it fixes
  90.      a bug found in both of the other unzip programs around for the Amiga.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.      In fact, that bug was one of the main reasons I go started writing
  98.      this unzip program.  It seems the other unzip programs only had a 256
  99.      character buffer for the file comment, and didn't check to make sure
  100.      that the file comment would fit in the buffer.  The local BBS,
  101.      however, puts a 540 byte comment on each ZIP file on their board.
  102.      Needless to say, when the unzip programs tried to fit a 540 byte
  103.      comment in a space designed to accommodate only 256 bytes, something
  104.      had to give.  The program would overwrite vital code and then get a
  105.      visit from the friendly neighborhood GURU!
  106.  
  107.      Features of this unzip program include:
  108.         Full ARP style (superset of AmigaDOS set) wildcards
  109.         Works with self-extracting ZIP archives (currently only IBM)
  110.         Sort by any of ten list fields
  111.         Extract to disk, screen, printer, or nowhere (checksum test)
  112.         List the contents of the archive in any of four styles:
  113.            40 columns, 76 columns, 96 columns, or multiple line
  114.         Automatically create subdirectories to recreate original
  115.            directory structure (with switch to disable)
  116.  
  117.      Features not yet supported:
  118.         Does not set the filestamp of the files it extracts
  119.         Does not add file comments to the extracted files
  120.         Does no tweaking of End-Of-Line characters on text files
  121.         Does not support archives spanning multiple disks
  122.         Does not support encrypted files
  123.  
  124.      _____________
  125.       Using Zippy
  126.      ~~~~~~~~~~~~~
  127.      Zippy only works from the CLI, and has a dozen optional arguments and
  128.      switches you can use.  Zippy requires the presence of the ARP library.
  129.      If you don't already have arp.library in your LIBS: directory, be
  130.      sure to copy the enclosed arp.library file there, and then see to
  131.      getting the full ARP command replacements as soon as possible -- they
  132.      represent large improvements over the original AmigaDOS commands.
  133.           
  134.      The general format of ZIPPY is:
  135.      
  136.      1> ZIPPY <major-command> <qualifiers> <zipfile> <internal-files>
  137.  
  138.      The arguments can be in any order, and running ZIPPY without any
  139.      arguments is the same as using the HELP qualifier.  None of the
  140.      arguments or filenames are case sensitive.  The following
  141.      commands/qualifiers are allowed:
  142.      
  143.      <major-command>
  144.      ---------------     
  145.         X or -X or EXTRACT  = Extract file(s) (default)
  146.         C or -C or CRT      = Extract file(s) to the current window
  147.         P or -P or PRINT    = Extract file(s) to the printer (PRT:)
  148.         T or -T or TEST     = Test integrity of file(s)
  149.  
  150.         L or -L or LIST     = Display contents of archive: 40 columns
  151.         V or -V or VERBOSE  = Display contents of archive: 76 columns
  152.         W or -W or WIDELIST = Display contents of archive: 96 columns
  153.         F or -F or FULLLIST = Display contents of archive: Multiple lines
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.         -> Note that it IS valid to specify both an extraction command
  161.            and a display command, but not more than one of each type.
  162.  
  163.  
  164.      <qualifiers>
  165.      ------------
  166.         TO <pathname> = Put extracted files in the directory specified by
  167.                         <pathname> rather than the current directory.
  168.         SORT <field>  = Sort archive directory before extracting/listing
  169.            <field> can be one or more of the following characters:
  170.               N = Sort by filename
  171.               T = Sort by type of file (ASCII, Binary, encrypted)
  172.               C = Sort by compression scheme
  173.               S = Sort by size of original file
  174.               Z = Sort by size of compressed file
  175.               % = Sort by compression ration (best to worst)
  176.               D = Sort by date of file
  177.               K = Sort by checksum of file
  178.               / = Reverse direction of immediately following sort type
  179.         NOPATH        = Strip subdirectory info before processing filenames
  180.         NOCOMMENT     = Ignore any comments in archive
  181.         NOCODES       = Force Zippy to use "clean" ASCII -- No CSI codes
  182.  
  183.      <zipfile>
  184.      ---------
  185.         This would be the name of the ZIP archive.  If you omit the .ZIP
  186.         suffix, Zippy will first try finding a file with the exact name
  187.         you specified; failing that it will add the .ZIP suffix and try
  188.         again.  You can include wildcards, in which case Zippy processes
  189.         all the matching files it finds in alphabetic order.  Note that
  190.         if you include wildcards, then Zippy will ONLY process files it
  191.         finds that end with the .ZIP suffix.
  192.         
  193.      <internal-files>
  194.      ----------------
  195.         Here you can specify one or more filenames to tell Zippy which
  196.         files in the ZIP file to consider for extraction/listing.  If you
  197.         don't specify any <internal-files>, Zippy assumes you want all the
  198.         files to be processed.  These filename can include wildcards.
  199.  
  200.      ____________
  201.       Past Tense
  202.      ~~~~~~~~~~~~
  203.         Version 1.00
  204.            First major public release
  205.            Support for compression schemes up to Reduced (4)
  206.            Bug in UnReduction routine would crash machine periodically
  207.            
  208.         Version 1.21
  209.            Extraction routines completely encoded in Assembly Language
  210.            Fixed bug in UnReduction routine
  211.            Support for Implosion compression scheme
  212.  
  213.  
  214.  
  215.  
  216.  
  217.      ______________
  218.       Future Tense
  219.      ~~~~~~~~~~~~~~
  220.      Some items I plan to add/fix in the next version are:
  221.         Full Date/Time filestamp support
  222.         Adding file comment to extracted file
  223.         File Decryption
  224.         Text file tweaking (i.e. End-of-Line conversions)
  225.         Better handling of overwriting existing files, creating
  226.            subdirectories, etc.
  227.         More consistant error message handling
  228.  
  229.      Some programs I plan to work on, in chronological order are:
  230.         Dizzy  - A no-frills version of Zippy, small and residentable
  231.         ZipExy - A program to make a ZIP file self-extracting
  232.         Zipper - A ZIP format archiver
  233.  
  234.      ___________________
  235.       The Gotcha <Grin>
  236.      ~~~~~~~~~~~~~~~~~~~
  237.      I have spent several hundred hours over the last many months writing
  238.      this program.  In addition, I don't have a lot of money, and WOULD
  239.      like to buy a hard drive sometime in the near future.  I might even
  240.      settle for a second floppy or a second meg of memory...  And all that
  241.      takes is...  everybody say it now...  MONEY!  Thus I am releasing
  242.      this program under the Shareware concept in the hopes that I'll be
  243.      able to get closer to my goal.  (You know a hard drive would REALLY
  244.      boost my productivity, and I could write more of these great
  245.      programs, and maybe get the "Zipper" program out before Christmas!
  246.      Grin.)  So...
  247.  
  248.              $25 gets you my gratitude, the latest version of Zippy,
  249.                 object code for the extraction routines so you can
  250.                 include them in your own program, Dizzy when it is
  251.                 finished, the program to make a zip file self-extracting
  252.                 (if/when I get that done), and the source to the above.
  253.                 You will also be a registered "friend" and will receive
  254.                 notices of other programs or upgrades.
  255.  
  256.              $15 gets you all of the above (including my gratitude)
  257.                 except the source.  You will also be a registered
  258.                 "friend" with all the duties and benefits that
  259.                 entails.
  260.  
  261.               $5 and a disk will get you the latest version of Zippy,
  262.                 and you still get my gratitude!  You will not,
  263.                 unfortunately, be a registered "friend", and while
  264.                 that does not mean I won't read your letters or
  265.                 answer your questions, I will have to take care of my
  266.                 registered "friends" first and handle my unregistered
  267.                 "friends" afterwards.
  268.  
  269.               $1 or any other amount will get you my gratitude.
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.      If you decide not to send any money (no pressure...  just try not to
  277.      think about this poor individual slaving away on a single floppy
  278.      based system, swapping disks all day, falling asleep waiting for
  279.      compiles to finish...  Grin), you may still use Zippy with my
  280.      blessing, although you won't get any of the goodies mentioned above,
  281.      not even my gratitude!  Grin.  If you DO use Zippy at least several
  282.      times a month, however, please do register it.  Remember, that I *DO*
  283.      hold the copyright on the program, so you can't try to sell it as
  284.      your own or wantonly steal code from it or use it unregistered in a
  285.      commercial environment.  If you have any questions about that, just
  286.      let me know and I'll try to be accommodating.
  287.  
  288.      If you are going to be using this program in a commercial setting,
  289.      you are required to register at the $15 or $25 level.  Contact me for
  290.      information about registering multiple copies for a quantity discount
  291.      or site license.
  292.  
  293.      Please use the order form on the next page or the file OrderForm.
  294.      Just print it out and fill in the blanks or circle your responses.
  295.  
  296.  
  297.  
  298.                             Registration form for Zippy
  299.                             ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  300.      Name: ___________________________________________________  Sex:  M  F
  301.  
  302.      Address: __________________________________________  Apt: ___________
  303.  
  304.      City: ________________________  State: ____________  Zip: ___________
  305.  
  306.      Zippy will be used in a commercial environment:    Yes    No
  307.  
  308.      If so, where? _______________________________________________________
  309.  
  310.  
  311.      Computer:  A500   A1000   A2000   Other _____________________________
  312.  
  313.      Number of floppy drives:  1  2  3  4  Other _________________________
  314.  
  315.      Total capacity of hard drives _______________________________________
  316.  
  317.      Do you have a modem?  No  Yes   Model _______________________________
  318.  
  319.      Other neat peripherals ______________________________________________
  320.  
  321.          _________________________________________________________________
  322.  
  323.      Favorite use(s) for your computer ___________________________________
  324.  
  325.          _________________________________________________________________
  326.  
  327.          _________________________________________________________________
  328.  
  329.      Comments ____________________________________________________________
  330.  
  331.          _________________________________________________________________
  332.  
  333.          _________________________________________________________________
  334.  
  335.      May I release this info to other individuals (not companies)
  336.      interested in corresponding with other Amiga users?  Yes  No
  337.  
  338.      I am sending my contribution of:  (Please circle)
  339.        $___ because I believe in supporting Shareware!
  340.         $25 for the full Zippy registration, next version, & source
  341.         $15 for the full Zippy registration & next version
  342.          $5 and a disk for the latest version of Zippy
  343.        $___ for your gratitude
  344.          $0 just to let you know that I have tried the program
  345.             and have some comments.  Sorry I can't give any
  346.             donation at this point.
  347.  
  348.      Total enclosed: $_______________________________
  349.  
  350.  
  351.      Please send this form and check or money order to:
  352.         David Godshall
  353.         137 Wagner
  354.         Elkhart, IN  46516
  355.  
  356.