home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / utility / ziprun21.zip / ZIPRUN.DOC < prev    next >
Text File  |  1992-08-11  |  14KB  |  449 lines
  1.  
  2.              Zip Runner Version 2.1 Documentation
  3.              ════════════════════════════════════
  4.              ════════════════════════════════════
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  ZIP RUNNER UPDATE INFORMATION:
  11.  ═════════════════════════════
  12.  
  13.  Version 2.0 was found to contain a glitch which would not let you
  14.  
  15.  install archives of similar names such as, TEST.ZIP and TEST1.ZIP. This
  16.  
  17.  bug has been corrected. You will notice that two additional files are
  18.  
  19.  contained in this package:
  20.  
  21.  ZIPRUN.EXE
  22.  ZIPRUN.DOC
  23.  LHARUN.EXE New!
  24.  ARJRUN.EXE New!
  25.  
  26.  LHARUN and ARJRUN function EXACTLY the same as ZIPRUN, with the exception
  27.  
  28.  of the fact that they work only with .lzh and .arj files respectively.
  29.  
  30.  The new runners utilize the same command line switches, mouse and key
  31.  
  32.  interfaces etc. In order for these two programs to work, LHA.EXE (not
  33.  
  34.  LH.EXE or LHARC.EXE!!!) or ARJ.EXE, must be in the directory with your 
  35.  
  36.  archives, or in your path. You can rename LH or LHARC to LHA. The 
  37.  
  38.  REGISTERED version of ZIP RUNNER now contains support for all three
  39.  
  40.  formats in one program!
  41.  
  42.  
  43.  NEW IN VERSION 2.0 & 2.1
  44.  ════════════════════════
  45.  
  46.  These NEW versions of ZIP RUNNER have the same outward appearance but an
  47.  
  48.  entirely new interface and several enhancements! You can now use your 
  49.  
  50.  mouse to turn pages or run the program of your choice!  Please read on
  51.  
  52.  for more information, and please REGISTER to gain the added benefit of
  53.  
  54.  swapping ZIP RUNNER to high memory! It may also make you feel GOOD to
  55.  
  56.  do the right thing, and support starving software authors.
  57.  
  58.  
  59.  PURPOSE:
  60.  ═══════
  61.  
  62.  The sole purpose of ZIP RUNNER is to save space on your hard drive.
  63.  
  64.  Many of the newer programs, especially games from vendors such as
  65.  
  66.  Apogee, consume over a megabyte of hard drive space when they are
  67.  
  68.  in their uncompressed form.  ZIP RUNNER allows a user to store
  69.  
  70.  programs in compressed format, but run them with ease from a menu.
  71.  
  72.  SETUP:
  73.  ═════
  74.  
  75.  To setup ZIP RUNNER, unzip it to the same directory as your zipped files 
  76.  
  77.  and run it. Since no files have been installed on the menu at this time, 
  78.  
  79.  will see the main ZIP RUNNER menu with only two options displayed: QUIT 
  80.  
  81.  and REVISE. Press "R" and you will go directly to the ADD a file section 
  82.  
  83.  of the REVISE menu. Here you will be asked if you want ZIP RUNNER to 
  84.  
  85.  automatically find the zipped file names for you. If you don't, Press "N" 
  86.  
  87.  and you can manually enter them. Once a zip file name is entered ZIP RUNNER 
  88.  
  89.  will display the first executable file name it finds in the zip, and ask 
  90.  
  91.  you if this is the executable you would like to run when the file is 
  92.  
  93.  unzipped. If it is, press "Y" or RETURN, and your first file is now
  94.  
  95.  installed. All future files are installed the same way. If you have more
  96.  
  97.  than one executable file in your zip, or want to run a .COM file, you can 
  98.  
  99.  answer NO to the prompt and enter the executable or com file name manually. 
  100.  
  101.  You will be asked to confirm. When asked for the names, enter them WITH or 
  102.  
  103.  WITHOUT the ".EXE" or ".ZIP" extensions. If you make a mistake no harm will 
  104.  
  105.  be done, but your program will not run until the bogus name is replaced 
  106.  
  107.  with the correct one. Once you have entered the names, you may elect to 
  108.  
  109.  unzip to a ram disk. This speeds up the unzipping process many times and is 
  110.  
  111.  highly recommended if you have enough memory. Press "C" for change, and 
  112.  
  113.  press "D" for drive. Now enter the letter of your ram drive. ZIP RUNNER 
  114.  
  115.  will write out its information to a small text file called "ZIPRUN.LUP", 
  116.  
  117.  and no further installation is required. Once installed, ZIP RUNNER will 
  118.  
  119.  always go directly to the menu when it is run. The text file, ZIPRUN.LUP, 
  120.  
  121.  must be in the same directory as ZIPRUN.EXE. The first line is the number 
  122.  
  123.  of zips in the file, the second, is the letter of the drive you will unzip 
  124.  
  125.  to. If you plan to unzip to the current drive, an 'x' will be found in on 
  126.  
  127.  this line. After the drive letter, the lines alternate between Zip filenames 
  128.  
  129.  (all in caps) and the executable names. (lower case) There is no conceivable 
  130.  
  131.  reason for editing the look up file, as the drive and file names can be 
  132.  
  133.  ADDED, DELETED and CHANGED using the REVISE option on the main menu. DO NOT 
  134.  
  135.  use a word processor to edit the file. Up to 32 files (two pages) can be
  136.  
  137.  entered on the menu. 
  138.  
  139.  RUNNING THE PROGRAM:
  140.  ═══════════════════
  141.  
  142.  In order for ZIP RUNNER to do its job, PKUNZIP.EXE and PKZIP.EXE MUST BE 
  143.  ------------------------------------------------------------------------
  144.  EITHER IN YOUR PATH, OR IN THE DIRECTORY WHICH CONTAINS YOUR ZIPPED FILES. 
  145.  -------------------------------------------------------------------------
  146.  
  147.  ZIP RUNNER will now display a menu of zipped files to choose from. Simply 
  148.  
  149.  press the letter key next to the filename you want to run, and ZIP RUNNER 
  150.  
  151.  goes to work. If you have installed more than 16 zips, a second page will 
  152.  
  153.  be available on the menu. Press the "T" key toggle the pages, or use the
  154.  
  155.  page up/down keys. For those of you who don't like the tweeting noise, press 
  156.  
  157.  the "S" key, which will toggle the sound on and off. The ESCAPE key will 
  158.  
  159.  either quit the revise menu or quit the program from the main menu. Use it 
  160.  
  161.  instead of "B"ack or "Q"uit if this is easier to remember. The "Z" key
  162.  
  163.  toggles the REZIP option and the status of REZIP will be displayed at the 
  164.  
  165.  top of the main menu. Since rezipping takes quite a bit of time, the default 
  166.  
  167.  status is "OFF", which means that the files will NOT be rezipped and saved 
  168.  
  169.  after program completion. If you have a game or other program which could 
  170.  
  171.  possibly save a file for later use, you should toggle the REZIP option to 
  172.  
  173.  "ON", BEFORE you run the program. REZIP can be set to ON automatically by 
  174.  
  175.  starting the program with the "r" switch, i.e. type "ZIPRUN R" or 
  176.  
  177.  "ziprun r" at the DOS command prompt. Likewise, the sound can be switched 
  178.  
  179.  off with the "s" switch. "ziprun r s" would start ZIP RUNNER with ths 
  180.  
  181.  sound off and the REZIP feature turned on. The "r" and "s" switches need 
  182.  
  183.  not be in this order.
  184.  
  185.  USING THE MOUSE:
  186.  ════════════════ 
  187.  
  188.  Once ZIP RUNNER is installed, those of you who have a mouse attached to 
  189.  
  190.  your computer system can run programs by clicking on them with the left 
  191.  
  192.  mouse button, or (if you have more than 16 zips on your menu) change pages
  193.  
  194.  by clicking the right mouse button.
  195.  
  196.  WHAT IT DOES:
  197.  ════════════
  198.  
  199.  First and foremost, ZIP RUNNER creates a new directory, "\__zr__", to which      
  200.  
  201.  the files will be unzipped, BEFORE it does anything else. When you make your 
  202.  
  203.  choice, the files are unzipped to either the current drive or the ram drive 
  204.  
  205.  if you have selected one. ZIP RUNNER then passes the executable file name 
  206.  
  207.  (which you entered for that zip file) to the command line, and the program 
  208.  
  209.  runs. When you terminate the program you selected, you will once again be 
  210.  
  211.  greeted with the ZIP RUNNER menu. By this time, the sub directory CREATED 
  212.  
  213.  by ZIP RUNNER, and all files contained therein, will have been deleted, and 
  214.  
  215.  ZIP RUNNER will be waiting to run another program. The last option on the 
  216.  
  217.  menu, "Revise" lets you ADD, CHANGE, or DELETE files on the menu. Just 
  218.  
  219.  follow the prompts and all should be well. You will be asked to confirm 
  220.  
  221.  adds, deletes, or changes, and at this time you may answer NO to the prompt 
  222.  
  223.  and be returned to the main revise prompt. Also shown with the revise prompt 
  224.  
  225.  are the free disk space of your chosen unzip drive, and the amount of 
  226.  
  227.  available conventional memory. If you change drives, the free disk space of 
  228.  
  229.  the new drive will be displayed. Press the "B"ack or ESC keys while in the 
  230.  
  231.  Revise menu, and you will be returned to the main menu. When you decide to 
  232.  
  233.  quit ZIP RUNNER, you will find yourself in the directory in which you 
  234.  
  235.  started when ZIP RUNNER terminates.
  236.  
  237.  MEMORY CONSIDERATIONS:
  238.  ══════════════════════ 
  239.  
  240.  At present, the unregistered version of ZIP RUNNER uses about 38K of 
  241.  
  242.  conventional memory. The registered version swaps ZIP RUNNER into high 
  243.  
  244.  memory while the daughter program is running, and uses only 2.5K of 
  245.  
  246.  conventional memory. 
  247.  
  248.  HOW MUCH DISK SPACE WILL THIS SAVE?
  249.  ═══════════════════════════════════ 
  250.  
  251.  Consider this; one Apogee game, #1WOLF3D requires 1,318,256 bytes of
  252.  
  253.  hard drive space in uncompressed form. In zipped format the same file
  254.  
  255.  resides in only 708,200 bytes, a savings of over 610,000 bytes!
  256.  
  257.  RAM DISKS SAVE TIME?
  258.  ════════════════════ 
  259.  
  260.  Files unzip and run on my ram disk in about 25% of the time it takes to 
  261.  
  262.  do the same job on my IDE 105 MEG hard drive, and file deletion is MUCH
  263.  
  264.  quicker!
  265.  
  266.  POSSIBLE PROBLEMS:
  267.  ══════════════════
  268.  
  269.  (1)
  270.  
  271.  Many programs, especially some of the newer games, require an installation
  272.  
  273.  of their own before they can be run. These programs should be installed
  274.  
  275.  in the proper directory (or on ram disk) then rezipped, before they are 
  276.  
  277.  added to the ZIP RUNNER menu. Take this opportunity to lose excess baggage
  278.  
  279.  such as BBS messages, unnecessary DOC files etceteras, before rezipping. 
  280.  
  281.  (2)
  282.  
  283.  Some programs may require more memory than is available with unregistered
  284.  
  285.  version of ZIP RUNNER running in the background. To solve this problem you
  286.  
  287.  can register ZIP RUNNER!
  288.  
  289.  (3)
  290.  
  291.  There may not be enough free disk space on your hard drive or ram disk. 
  292.  
  293.  To check this or your current free memory, press the "R"evise key and check 
  294.  
  295.  the display above the menu. To solve this problem, zip up more of your files
  296.  
  297.  and install multiple copies of ZIP RUNNER.
  298.  
  299.  (4)
  300.  
  301.  While testing the program, I ran across a zipped file, #1COSMO, which had a 
  302.  
  303.  bogus .EXE string in the zip. This string was displayed by ZIP RUNNER as
  304.  
  305.  the executable file name... In this case I had to manually enter the 
  306.  
  307.  correct file name before the program would execute. There may be a few 
  308.  
  309.  more zipped files like this out there, so be aware and ready to enter the
  310.  
  311.  right name. To correct this problem, unzip the file and check the executable 
  312.  
  313.  name. Compare it to the executable name in the ZIPRUN.LUP file. If there 
  314.  
  315.  is a difference, change the name in the LUP file to match that of the one 
  316.  
  317.  in the zip. You can do this from ZIP RUNNER by choosing "[C]hange" and 
  318.  
  319.  "[F]ile" from the REVISE menu.
  320.  
  321.  
  322.  IS IT FREE?
  323.  ═══════════
  324.  
  325.  NO!
  326.  
  327.  ARE THERE ADVANTAGES TO REGISTERING?
  328.  ════════════════════════════════════
  329.  
  330.  YES! 
  331.  
  332.  The registered version of ZIP RUNNER swaps itself into high memory while 
  333.  
  334.  other programs are running, thus giving nearly all free conventional memory 
  335.  
  336.  to the daughter program! 
  337.  
  338.  Registered users can feel free to make suggestions, bug reports or what have 
  339.  
  340.  you. (No one else can AFFORD to squwak!)
  341.  
  342.  HOW MUCH DOES IT COST?
  343.  ══════════════════════
  344.  
  345.  The registration fee is $15.00 American.
  346.  
  347.  WHERE DO I SEND IT?
  348.  ═══════════════════
  349.  
  350.  Bob Sherburne
  351.  1213 Sattes St.
  352.  Las Vegas, Nevada 89101
  353.  (702) 642-4030
  354.  
  355.  THANKS!
  356.  ═══════
  357.  
  358.  Many thanks to my Beta Testers, John Martin, Cindy Mitchell, and Chuck Hunt. 
  359.  
  360.  I think beta testers isn't quite appropriate because all these people also 
  361.  
  362.  provided many good ideas and lots of useful input. But, if there are any 
  363.  
  364.  problems with the program, Now you know who to blame! <G>
  365.  
  366.  Thanks also to John Wagner, author of IMPROCES, for providing some great 
  367.  
  368.  ideas, many useful programming hints. 
  369.  
  370.  This is my first commercial program written in Turbo C, and it has been a 
  371.  
  372.  learning experience!
  373.  
  374.  Last but not least, THANKS to my wife, Kathi...
  375.  
  376.  ZIP RUNNER(C).  Copyright Bob Sherburne 1992.  All rights reserved.
  377.  ═══════════════════════════════════════════════════════════════════
  378.  
  379.  DISCLAIMER AND LEGAL NOTICES:
  380.  ═════════════════════════════       
  381.  
  382.  I, Bob Sherburne retain ALL rights to distribute and collect fees for this 
  383.  
  384.  software. This software IS NOT RELEASED TO THE PUBLIC DOMAIN. IT IS NOT 
  385.  
  386.  FREE. It is OWNED by me and only me. As a user, you have the right to 
  387.  
  388.  possess and distribute this software. You MAY NOT COLLECT ANY FEE, real or 
  389.  
  390.  otherwise for the transfer of this of this software without prior written 
  391.  
  392.  consent. All files included in this package must be distributed together 
  393.  
  394.  and may not be modified in ANY WAY by anyone other than myself. I reserve 
  395.  
  396.  the right to refuse anyone the right to distribute this software with a 
  397.  
  398.  written notice.
  399.  
  400.  DISCLAIMER NOTICE:
  401.  ══════════════════
  402.  
  403.  This program was written by Bob Sherburne. I, Bob Sherburne accept NO
  404.  
  405.  RESPONSIBILITY for ANY damages, real or otherwise that this program
  406.  
  407.  may cause. I make no guarantees that this program will work as described 
  408.  
  409.  in this document. This software is provided "AS IS" with NO GUARANTEE, 
  410.  
  411.  expressed or implied. 
  412.  
  413.  USER LICENSE
  414.  ════════════
  415.  
  416.  REGISTERED USERS:
  417.  
  418.  Users who have registered ZIP RUNNER may use the program, or multiple 
  419.  
  420.  copies of the program, on a single computer. The registered version of the 
  421.  
  422.  program may be placed on more than one computer, provided it is not 
  423.  
  424.  possible to use more than one copy at a time.
  425.  
  426.  UNREGISTERED USERS:
  427.  
  428.  Users who have not registered their copy of ZIP RUNNER, are hereby granted 
  429.  
  430.  permission to evaluate ZIP RUNNER for a period of one month before they must 
  431.  
  432.  discontinue using the program or register a copy. This one month period 
  433.  
  434.  starts when the package is received by the user.
  435.  
  436.  ACKNOWLEDGMENTS:
  437.  ═══════════════
  438.  
  439.  PKZIP and PKUNZIP are Copyrighted (C) property of PKWare.
  440.  ARJ is Copyrighted (C) property of Robert K Jung.
  441.  LHA, LH, and LHARC are Copyrighted (C) property of Haruyasy Yoshizaki.
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.