home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d521 / batchmaster.lha / BatchMaster / BatchMaster.doc < prev    next >
Text File  |  1991-08-05  |  3KB  |  84 lines
  1. BatchMaster.doc                BatchMaster v.1.27    07/24/91
  2.  
  3.     1) Installation
  4.  
  5.     It is an easy task to install BatchMaster; you just copy BatchMaster
  6.     file to the directory you want to, for example, the "c/"directory. 
  7.     There is nothing else to do, except to ensure you have arp.library
  8.     in your "libs/" directory, since BatchMaster will not work without
  9.     arp.library.
  10.  
  11.     2) Usage (BatchMaster arg1 arg2 arg3 arg4)
  12.  
  13.     To use BatchMaster, you must create command script file. If you are
  14.     completely green with script files, you can follow the instructions
  15.     step by step:
  16.     - Load your favorite text editor.
  17.     - Type in command script. For example,
  18.         
  19.         BatchMaster kidding no_kidding bmdemo
  20.         echo "If this text gets out, there is an error!"
  21.         echo "Refer to file BatchMaster.doc."
  22.         lab kidding
  23.         echo "Just kidding!"
  24.         skip batchend
  25.         lab no_kidding
  26.         echo "No kidding!"
  27.         skip batchend
  28.         lab bmdemo
  29.         echo "This is a command script that demonstrates BatchMaster"
  30.         lab batchend
  31.         
  32.       is a non-useful command script that uses BatchMaster. This command
  33.       script should be found at name "BatchMaster.demo".
  34.  
  35.     - Type "execute <command_script_name>" to run the command script. If
  36.       you are working with Shell, you can run the program directly without
  37.       the command "execute", if the bits s and e of the command script
  38.       file are set. You can use the command "protect" to set these bits.
  39.  
  40.     As demonstrated in BatchMaster.demo command script, BatchMaster uses
  41.     its arguments as names of labels where jump to. That´s why you have to
  42.     have a line "lab arg" if you have line "BatchMaster arg .." in your
  43.     command script file. Otherwise, if the user selects the option "arg",
  44.     and there isn´t line "lab arg", BatchMaster causes an error.
  45.     Currently, BatchMaster can only jump forward.
  46.     Examples:
  47.     
  48.     example1
  49.         ...
  50.         BatchMaster arg1 arg2 arg3
  51.         ...
  52.         lab arg1
  53.         ...
  54.         lab arg2
  55.         ...
  56.         <eof>
  57.  
  58.     If the user selects arg3, BatchMaster stops into an error. To correct
  59.     the bug we have to either remove arg3 from line "BatchMaster arg1 
  60.     arg2 arg3", or we have to add line "lab arg3", according to situation.
  61.  
  62.     example2
  63.         ...
  64.         lab arg1
  65.         ...
  66.         BatchMaster arg1 arg2 
  67.         ...
  68.         lab arg2
  69.         ...
  70.         <eof>
  71.  
  72.     BatchMaster can jump only forward, so to prevent error we have to 
  73.     move line "lab arg1" after line "BatchMaster arg1 arg2".
  74.  
  75.     BatchMaster does not recognise a gadget if it does not have an
  76.     argument. If no arguments are given, BatchMaster gives an option
  77.     to escape from BatchMaster by clicking the upper left gadget.
  78.     BatchMaster uses argument ? as special argument. The user can type
  79.     the argument name from his/her keyboard.
  80.  
  81.     I´ll hope you enjoy this program!
  82.  
  83.     Janne Pelkonen
  84.