home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / c128 / archivers / nzp12811.sfx / unzip128.docs < prev    next >
Text File  |  1990-02-12  |  8KB  |  199 lines
  1.              UNZIP128 v1.1 (C)1994 by David Schmoll: 04-25-94
  2.  
  3.  
  4.       =====================================================================
  5.       =                             UNZIP128                              =
  6.       =====================================================================
  7.       
  8.     COPYRIGHT:
  9.       
  10.       I  have  decided  to  distribute  UNZIP128  as FREEWARE with the only
  11.       requirement  that  the  distribution of this software be left in it's
  12.       original   distibution   form  -  donations  of  $10  are  of  course
  13.       appreciated:)  This  version is being release with the full knowledge
  14.       and  cooperation  of Bill Lucier, the author of the original UNZIP64,
  15.       which this version is based on  - see below.
  16.       
  17.       David Schmoll
  18.       1703 Pagosa Way
  19.       Aurora, Colorado 80011
  20.       USA
  21.       
  22.       I  am  currently also available on the CBM and CBM-128 FIDO Echo's to
  23.       answer  any  questions or suggestions you may have. I am able to send
  24.       and receive Internet mail at the below address as well.
  25.       
  26.       david.schmoll@f518.n104.z1.fidonet.org
  27.       
  28.       Netmail can be received at 1:104/518
  29.       
  30.       Please do not distribute this program except in the original archive!
  31.       
  32.       ---------------------------------------------------------------------
  33.       
  34.       Text import from Bill Lucier
  35.       
  36.       From: blucier@ersys.edmonton.ab.ca on 1:1/31, fidonet.org, Piscataway
  37.       NJ
  38.       
  39.       I don't have a problem with you distributing it. But please include a
  40.       note  with  a  way  of contacting you if someone needs to, and a line
  41.       that  you  released  it with my permission, so there is no hold up on
  42.       any of the online services.
  43.       
  44.       ---------------------------------------------------------------------
  45.       
  46.     PROGRAM DESCRIPTION v1.1:
  47.       
  48.       UNZIP128  is a stand alone 128 utility that allows you to unzip PKZIP
  49.       V1.xx archives. UNZIP128 runs in either 40 or 80 columns, and has all
  50.       the features of UNZIP64, with the added support of a Dos command line
  51.       (wedges)  and  CMD drive (Ramlink, Ramdrive, Hard drive, FDx000) path
  52.       support.  To  use  UNZIP128  just  load  and run it as a normal basic
  53.       program,  even  though  it  is  machine language program with a basic
  54.       header.
  55.       
  56.     QPE UNZIP MODULES:
  57.       
  58.       I have also included a QPE subset version of UNZIP128 that runs under
  59.       the BASIC program QPE (QWK Packet Extractor), written by  myself with
  60.       input  from  Russell  Prater  - the current moderator of the CBM FIDO
  61.  
  62.  
  63.  
  64.                                                                      Page 1
  65.  
  66.  
  67.              UNZIP128 v1.1 (C)1994 by David Schmoll: 04-25-94
  68.  
  69.  
  70.       ECHO.  The  purpose of QPE is to interface the UNZIP modules with the
  71.       QWK offline reader QWKRR128 to create a more automated environment to
  72.       process  QWK  mail  packets.  The  machine  language code for this is
  73.       called  UNZIP1.ML,  UNZIP2.ML, and UNZIP3.ML. To use this option just
  74.       load  and  run  QPE instead of QWKRR128. See the documentation on QPE
  75.       for further details.
  76.       
  77.       Please  do not distribute these special UNZIP modules separately from
  78.       the main UNZIP128 package.
  79.       
  80.       ---------------------------------------------------------------------
  81.       This  version  corrects  a  bug  that returned an unidentified header
  82.       error  with  some systems. What was happening was  a byte was getting
  83.       lost  due to two calls to the the Kernal routine chkin without a call
  84.       to  clrch between them. This problem hit on a random basis and seemed
  85.       to affect non JiffyDos systems the most!
  86.       ---------------------------------------------------------------------
  87.       
  88.     The UNZIP128 menu presents you with the following options:
  89.       
  90.     SOURCE PATH (+):
  91.       
  92.       The drive path of the file to be unzipped. Non CMD users will use 0:,
  93.       while CMD users will give the path location, such as "3//wherever/:".
  94.       
  95.       * Note the ending colon in all cases!
  96.       
  97.     TARGET PATH (-):
  98.       
  99.       The  drive  path of where the unzipped files are to go. Non CMD users
  100.       will  use  0:,  while  CMD users will give the path location, such as
  101.       "3//wherever/:".
  102.       
  103.       * Note the ending colon in all cases!
  104.       
  105.     SOURCE DOS (@):
  106.       
  107.       This  is  a  dos  wedge  which  defaults to the current source drive,
  108.       unless you put a path command in the dos command itself. There is one
  109.       exception  to  this, the $ with no other parameters. In this case you
  110.       are  given  a  directory  for  the  path  you have set. If you want a
  111.       directory of the current partition use $:*
  112.       
  113.     TARGET DOS (*):
  114.       
  115.       This  is  a  dos  wedge  which  defaults to the current target drive,
  116.       unless you put a path command in the dos command itself. There is one
  117.       exception  to  this, the $ with no other parameters. In this case you
  118.       are  given  a  directory  for  the  path  you have set. If you want a
  119.       directory of the current partition use $:*
  120.       
  121.     SOURCE DRIVE (1):
  122.       
  123.       The unit number of the drive on which the zipped file is located.
  124.       
  125.     TARGET DRIVE (2):
  126.       
  127.  
  128.  
  129.  
  130.                                                                      Page 2
  131.  
  132.  
  133.              UNZIP128 v1.1 (C)1994 by David Schmoll: 04-25-94
  134.  
  135.  
  136.       The unit number of the drive where the unzipped files are to go.
  137.       
  138.     FAST MODE (3):
  139.       
  140.       This toggles between the 1 and 2 MHZ speeds on the 128. Fast mode can
  141.       be  on  or  off in 40 column mode, but is always on in 80 column mode
  142.       regardless of the setting.
  143.       
  144.     CRC CHECKING (4):
  145.       
  146.       This is a checksum indicator of the file's integrity after unzipping,
  147.       and can be turned on or off.
  148.       
  149.     FILE TYPE (5):
  150.       
  151.       Output  file  type  can  be  set  to  either  program  or sequential,
  152.       depending upon your needs, with sequential as the default. Note input
  153.       file type does not matter!
  154.       
  155.     UNZIP A FILE (6):
  156.       
  157.       This  is  the  actual  unzip  routine.  After  setting  all the above
  158.       settings, press this choice.  The first thing that happens is a check
  159.       is  made  to verify the drive choices are valid before proceeding. If
  160.       an  error  occurs  you  are returned to the menu to make corrections,
  161.       otherwise  a  directory  comes up with all the ZIP's on the requested
  162.       disk.  In  none  exist you will be prompted and returned to the menu,
  163.       otherwise the files are displayed 14 at a time. You can scroll up and
  164.       down to access the desired file by pressing return on the highlighted
  165.       name.
  166.       
  167.       For  each  file  contained in the archive, the file compression type,
  168.       name,  and  byte  count are printed to the screen. You can select all
  169.       files  or  individual  files  to unzip as you go along. If the output
  170.       file  already  exists, you will be prompted to either replace or skip
  171.       the file. The number of bytes remaining to unzip are displayed so you
  172.       can  see  how things are going - this sure helps on those long files!
  173.       The  CRC  status is printed at the end of each file. A CRC error will
  174.       not  abort  the  unzipping,  but  a bad compression method or unknown
  175.       header error will. At the end you are returned to the main menu.
  176.       
  177.     EXIT (7):
  178.       
  179.       This option exits UNZIP128 and returns you to basic. All the defaults
  180.       except  path  are  intact if you choose to run unzip128 again for any
  181.       reason at this time - assuming no other program is run!
  182.       
  183.       
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                      Page 3
  197.  
  198.  
  199.