home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 600-699 / ff642.lha / AutoCLI / AutoCLI.doc < prev    next >
Text File  |  1992-04-26  |  40KB  |  843 lines

  1.                 AutoCLI by Nic Wilson
  2.                 ---------------------
  3.         
  4.                 Nic Wilson Software
  5.                 138d South Street
  6.                 TOOWOOMBA Queensland 4350
  7.                 Australia 
  8.                 
  9.         Phone   (076) 358539  Home Voice only
  10.                 (076) 358384  Work or Fax
  11.                 (076) 358522  Work Voice only
  12.                 
  13.         EMAIL   cbmvax!cbmaus!wilson!nic@uunet.uu.net
  14.           OR    cbmehq!cbmaus!wilson!nic@cbmvax.commodore.com
  15.             
  16.  
  17.  
  18.         Written in 100% Assembler using Macro68 on an Amiga 3000/PP&S 68040.
  19.  
  20.         AutoCLI is ShareWare.  I have not disabled it in any way.
  21.         This is so you can get full benefit immediately.  If you use 
  22.         it then please send a small donation and help me to bring more
  23.         programs to the Amiga.  Suggested donation is $20.00. Donations 
  24.         will be accepted in any currency.  Mastercard, Visa or Bankcard can 
  25.         also be accepted by mail or by telephone.  Overseas users, please 
  26.         do not send personal or Bank cheques.  Easiest form of payment from
  27.         overseas is cash funds, American Express Travellers Cheques or 
  28.         alternately, disks are an acceptable form of payment.   
  29.         
  30.         Permission is hereby granted to distribute this program on the
  31.         condition that no profit is gained gained from its distribution.
  32.         All document files must accompany it and remain unchanged.  If the
  33.         document files are crunched, then a suitable de-cruncher must also
  34.         be supplied with them that works on ALL model Amigas.  
  35.         It MAY NOT be distributed on those so called 'copyright' non 
  36.         distributable PD disks.  It MAY be distributed on a BBS as long as 
  37.         that BBS does NOT have individual charges for downloading of files.  
  38.         
  39.         Please send any bug reports or ideas to the address at the top of 
  40.         this file. 
  41.  
  42.         Commercial companies wishing to distribute, may contact me at the
  43.         address at the top of this file.
  44.  
  45.         This program is now fully tested an all Amiga models including
  46.         the A3000 and 68040 processor.  Full testing is also done with 
  47.         'enforcer' a debugging program that uses the MMU to look for and 
  48.         display invisible bugs.  I have found 'enforcer' to be a worth-
  49.         while tool for programming.  
  50.  
  51. NEW DOC FILE FROM V2.00
  52. -----------------------
  53.         Bugs and history has now been moved to a seperate file called
  54.         'autocli.history.doc'.  This allows for less cluttered docs.
  55.         Check this file for the latest version number.
  56.  
  57. ************************************************************************
  58. ABSOLUTELY IMPORTANT WHEN UPDATING TO A NEWER VERSION OF AutoCLI
  59. ----------------------------------------------------------------
  60.         There MUST only be one copy of AutoCLI in the current path.
  61.         Otherwise the special re-launcher code may find an older version
  62.         first and install it instead of the one you just loaded.  
  63.         Because newer version have new switches, and you may be using 
  64.         these, it could cause erratic results if these were used on an 
  65.         older version.  After installation you can check the installed
  66.         version by looking in the option window.
  67. ************************************************************************
  68.  
  69. KNOWN BUGS OR CONFLICTS
  70. -----------------------   
  71.         Problems have been encountered with non standard versions of
  72.         the 'RUN' command.  This command is called by 1.3 dos.library's 
  73.         'execute' function.  If you have problems with the Amiga crashing
  74.         when a CLI is popped up then make sure the 'run' command is
  75.         standard.  The one to use is the one you can find on a standard
  76.         Workbench disk.  It is not recommended that ARP Library commands
  77.         be used. I have found them to be the source of many problems. 
  78.         
  79.         Some users have had problem popping up the first window.  This
  80.         has been tracked down to a fault in your 'MOUNTLIST' file in 
  81.         devs.  Ensure that the NEWCON: handler entry is 'L:shell-seg' and
  82.         not 'L/shell-seg'. 
  83.  
  84. SUGGESTIONS
  85. -----------
  86.         If AutoCLI does not have your favourite function, or you can think
  87.         of any improvements, then write and tell me.  The very best
  88.         suggestions receive a FREE copy of my commercial NoVirus program
  89.         or AddMenu Plus Icons.  Include your telephone or fax number so
  90.         I can contact you if you are a winner.  Only registered users that
  91.         have dontated are eligible to enter.
  92.  
  93. NIC'S PROGRAM SUMMARY
  94. ---------------------
  95.         This program was written because of problems with the similar
  96.         program I had been using called 'popcli'.  Popcli crashed if used
  97.         under WorkBench/KickStart 2.0, and if used on a PAL Amiga to open
  98.         a CLI window with a vertical size greater than 200 lines, it did
  99.         not open if your Amiga decides to start in NTSC mode.  Popcli also
  100.         seems to waste CPU time when waiting and doesn't allow you to 
  101.         remove it from memory without crashing or a reboot.  AutoCLI 
  102.         will overcome all of the above problems and has many added features
  103.         equivalent to other programs around, but uses much less CPU time.
  104.         The biggest problem with all the others, is that they lose the 
  105.         Current directory, stack and path.  AutoCLI retains all this 
  106.         including the current directory when the program was launched, 
  107.         it will place you in this directory every time you open a CLI or
  108.         Shell.  Other programs such as DMouse or Mackie had their own 
  109.         individual problems and some have erratic results on a 68040.
  110.         I could not find any written in 100% assembler.  So I decided to 
  111.         write AutoCLI, and with lots of response from the Amiga Community 
  112.         has grown into the most powerful and fastest utility of its type 
  113.         on the Amiga.  I thank all those who have supported AutoCLI by 
  114.         sending their donations, comments and or suggestions.
  115.  
  116.  
  117. FEATURES
  118. --------
  119.         * Kickstart / Workbench 1.2, 1.3, 2.0x compatible
  120.  
  121.         * Compatible with A500, A1000, A2000, A2500, A3000, inc. 68040
  122.  
  123.         * New Anti-Virus Event handler monitors your memory
  124.  
  125.         * Automatically checks and warns of restart vector changes
  126.  
  127.         * Default or custom CLI / Shell windows
  128.  
  129.         * Default windows open to 1 pixel less than current screen
  130.         
  131.         * 20 Function key scripts 
  132.  
  133.         * Update completely after launch
  134.  
  135.         * Asynchronous 'options window' allows modification while running
  136.         
  137.         * Option window can be opened in your specified location
  138.  
  139.         * Active window to front, double click or point to front options
  140.  
  141.         * Screen shuffle option with keyboard or mouse control
  142.         
  143.         * Window shuffle option
  144.  
  145.         * Screen blanking after time period, and optional spline patterns
  146.  
  147.         * Mouse blanking on key press or time option
  148.  
  149.         * Mouse acceleration with optional speeds
  150.         
  151.         * Slow down hot key for mouse accelleration function
  152.  
  153.         * Auto Window activation on a key press/mouse position option.
  154.  
  155.         * Option to swap mouse buttons for left handed users
  156.  
  157.         * Auto formatting of disks via 'Arq & Upd' compatible requesters
  158.  
  159.         * Selectable task priority and screen blanked priority
  160.  
  161.         * No CPU time wastage
  162.  
  163.         * 100% assembly language, written in Devpac and Macro68
  164.  
  165.         * Freely distributable Shareware program
  166.         
  167.         * Plus much much more...
  168.        
  169.  
  170. PROGRAM USAGE FOR INSTALLING AutoCLI
  171. ------------------------------------
  172.  
  173. AutoCLI [<optional switches>] [<optional seconds>] [<optional command>]
  174.  
  175.         YOU MUST NOT USE RUN or RUNBACK when launching AutoCLI.  It will 
  176.         return the command line prompt and allow the window it was launched
  177.         from to close, when an 'ENDCLI' command is given.  It still retains
  178.         the directory it was launched from and does not lose the current
  179.         path or stack.  This means when a CLI is popped up, it will 
  180.         default to the directory that was current, when AutoCLI was
  181.         launched.  The path and stack that was set, will still be valid. 
  182.  
  183.         The program is mainly designed to be used in your startup-sequence
  184.         (or user-startup in V2.0x), so you will always have a CLI or Shell
  185.         window available very conveniently.  AutoCLI MUST reside in your
  186.         C: directory or be in a directory in the path.
  187.  
  188.  
  189. OPTIONAL SWITCHES
  190. -----------------
  191.         The following switches do not have to be given in any particular
  192.         order, but must all be before the optional seconds and command
  193.         parameters, and at least one space between each one.  All options 
  194.         default to OFF and must be enabled with a switch.
  195.  
  196.         Any of these options can be modified after launch, by using the 
  197.         Option Window provided. (see OPTIONS WINDOW below)
  198.  
  199. -c<filename>
  200.  
  201.         This switch allows you to give your option switches in a file
  202.         rather than on the command line at launch.  This allows different
  203.         configurations to be easily loaded.  If this switch is used, any
  204.         other options on the command line will be ignored, in preference
  205.         of the new options in the file.  The filename can be any name you 
  206.         desire, and must be of the same format as if the options were typed 
  207.         at the command line (excluding the word 'AutoCLI' at the beginning).
  208.         If you experience problems with this file, ensure that the file
  209.         does not have an extraneous characters in the file, the file consists
  210.         of a single line terminated with a carriage return (preferably).
  211.         A default filename of 'S:autocli.cmd' can also be used by omitting 
  212.         this switch entirely.  
  213.         
  214.         If this switch is given when AutoCLI is already running, the current
  215.         running copy of AutoCLI will be updated to reflect the options in 
  216.         the suppled file.  This is also true if it is launched again with no 
  217.         parameters at all (default filename), the current running version 
  218.         will attempt to read the default file 'autocli.cmd' and update all 
  219.         options. 
  220.                 
  221.         EXAMPLES
  222.         --------
  223.         AutoCLI -cs:myfile - Loads the file 'myfile' from the S: directory.
  224.         AutoCLI            - Loads the file 'autocli.cmd' from S:directory.
  225.         
  226.  
  227. FUNCTION KEY SCRIPTS
  228. --------------------
  229.  
  230. -f<r>[n]    
  231.  
  232.         This switch enables function key trapping.  When your qualifier
  233.         (see below) is held down and a function key pressed, the       
  234.         program will execute a script file in the assigned S:          
  235.         directory with a filename of autocli.f1 to autocli.f10.      
  236.         This file must be a normal script (eg. startup-sequence).
  237.             
  238.         The extra two switches <r> and [n] are for changing the qualifier
  239.         for the extra 10 keys giving a total of 20 function key scripts.
  240.         The optional 'r' parameter forces the qualifier for these 10 to 
  241.         be the right hand key of 'n'. The 'n' parameter tells AutoCLI 
  242.         which key you want as the qualifier for these extra 10 function
  243.         key scripts.  If none of these are given the it will default to
  244.         the Right Amiga key.  The other choices are as shown below in the
  245.         example.  Filenames for these extra 10 must be:- autocli.e1 to 
  246.         autocli.e10.  These files as above must be in the assigned S:
  247.         directory and be a normal script files.
  248.             
  249.     EXAMPLES
  250.                     
  251.     -f    Gives extra 10 and the second qualifier is Right Amiga 
  252.     -frd  Gives extra 10 and the second qualifier is Right Amiga (AS FOR DEFAULT)
  253.     -fra  Gives extra 10 and the second qualifier is Right Alt
  254.     -frs  Gives extra 10 and the second qualifier is Right Shift
  255.     -fc   Gives extra 10 and the second qualifier is Control          
  256.     -fd   Gives extra 10 and the second qualifier is Left  Amiga
  257.     -fa   Gives extra 10 and the second qualifier is Left  Alt
  258.     -fs   Gives extra 10 and the second qualifier is Left  Shift
  259.     
  260.         Please note that the second qualifier MUST be different to the
  261.         normal qualifier key that you have chosen.  If you select the
  262.         same then the AutoCLI will display an error window.
  263.             
  264.     *************************************************************
  265.             
  266.     FILENAMES FOR FIRST 10 SCRIPTS:-  S:autocli.f1  to  S:autocli.f10
  267.     FILENAMES FOR EXTRA 10 SCRIPTS:-  S:autocli.e1  to  S:autocli.e10
  268.            
  269.     *************************************************************
  270.             
  271.     
  272. WINDOW TO FRONT
  273. ---------------
  274.  
  275. -w[n]       
  276.  
  277.         This switch enables the window to front option.  The optional
  278.         parameter [n] selects the action required to bring it to the
  279.         front.  0 = use keyboard, 1 = use mouse.  To use keyboard 
  280.         activate the window you want at the front by clicking the left 
  281.         mouse inside the window and then hold your qualifier key 
  282.         (see below) and pressing the Left ALT key. 
  283.         To use the mouse simply place the mouse in the window you
  284.         want at the front and the window will immediately appear at
  285.         the front.  Both can be temporarily disabled via the option
  286.         window.
  287.         
  288.         EXAMPLES
  289.          
  290.         for keyboard   -w0   or  -w
  291.         for mouse      -w1
  292.  
  293.         
  294.         DOUBLE CLICK TO FRONT
  295.         ---------------------
  296. -d      This switch if given, enables double click to front windows.
  297.         The time period for double click is taken from your workbench 
  298.         preferences settings.        
  299.         
  300. SCREEN SHUFFLE
  301. --------------          
  302.  
  303. -n[n]       
  304.  
  305.         This switch enables the screen shuffle option.  Two optional
  306.         parameters for [n] are 1 or 2.  1 enables or disables the mouse 
  307.         activated part of the screen shuffling.  If you want the mouse 
  308.         activation then you can leave this parameter off (eg. -n) 
  309.         If you want to disable this feature in case of conflictions with
  310.         other programs such as DirectoryOpus then use -n1.  The third
  311.         option is 2 which enables the mouse activated part as -n does,
  312.         but stops the screen being activated when brought to the front.
  313.             
  314.         EXAMPLES
  315.         
  316.         for keyboard & mouse activated with screen activation    -n  
  317.         for keyboard only with screen activation     -n1
  318.         for keyboard & mouse with no screen activation -n2
  319.                 
  320.         To use this function, hold down your qualifier key and use the 
  321.         cursor up or down keys to rotate all screens in opposite 
  322.         directions. 
  323.         If you prefer you can hold down the left mouse button and 
  324.         click the right button to shuffle the screens (if enabled).
  325.             
  326.         Screen shuffle is different to the standard LEFT AMIGA N & M,
  327.         on Kickstart 1.3.  These standard keys only swap between the front 
  328.         and rear most screens.
  329.             
  330. WINDOW SHUFFLE
  331. --------------            
  332.  
  333. -m          
  334.         This switch enables the window shuffle option.  To use this
  335.         function, hold down your qualifier key and use the cursor
  336.         left or right keys  This will move the front most window to
  337.         the back or the back most window to the front respectively.
  338.         The window shuffle always occurs on the screen that is at
  339.         the front.  This allows you to easily move between windows
  340.         and screens (-n) by using the qualifier and all the cursor keys
  341.         
  342.         Alternatively you can hold down you left qualifier and click
  343.         the left mouse button instead of the cursor keys.  This will move 
  344.         the top most window to the back.
  345.     
  346. MOUSE ACCELERATION
  347. ------------------    
  348. -q[n]        
  349.  
  350.         This switch enables mouse acceleration.  The optional parameter
  351.         [n] is a speed from 1 to 3.  Speed 1 will multiply all mouse 
  352.         movements by a factor of 2.  Speed 2 will multiply by a factor of
  353.         4, and speed 3 is a special case, it will multiply by the amount
  354.         the mouse actually moved, this mode was preferred by a lot of
  355.         users because it will give a small acceleration if the mouse is
  356.         moved a short distance, increasing more and more the further and
  357.         faster you move the mouse.  This function works in conjunction
  358.         with mouse speed under preferences, so this can also be changed to
  359.         find the best possible combination that you like.  If this second
  360.         paramter is not given then it will default to speed 1.  
  361.         
  362.         EXAMPLES
  363.          
  364.         for 4 times speed up the switch should be -q2
  365.         for default speed of 2 times it should be -q
  366.         for automatic linear speed increase       -q3
  367.  
  368.         
  369. MOUSE ACCLERATION SLOW DOWN KEY
  370. -------------------------------
  371.         
  372.         Mouse accelleration can be temporarily slowed down for fine control
  373.         of the mouse by holding down your first qualifier key.
  374.              
  375.         
  376. TASK PRIORITY   (NOT RECOMMENED TO BE CHANGED)
  377. -------------   ------------------------------
  378.  
  379. -p<b>[n]        
  380.  
  381.         This double switch allows you to change the priority of the
  382.         main AutoCLI task running normally and also when the screen is
  383.         blanked.  Without this switch the normal priority will default to 
  384.         21, and the blanked priority will default to -10.  Valid values for 
  385.         [n] are 0 - 21, and -10 - 0 for blanked priority. Bad values will 
  386.         cause erratic operation. ENSURE CORRECT VALUES.  
  387.         Blanked priority is lower, as this stops the blanking code from 
  388.         stealing too much time from other background tasks.
  389.         
  390.         EXAMPLES (MAIN TASK)
  391.          
  392.         for a priority of 0  the switch should be -p0
  393.         for a priority of 20 the switch should be -p20
  394.         
  395.         EXAMPLES (BLANKED TASK) 
  396.          
  397.         for a priority of -5 the switch should be -pb-5
  398.         for a priority of  0 the switch should be -pb0
  399.              
  400.      * * * NOTES * * *
  401.              
  402.         1. If the main priority is changed from 21, some functions may 
  403.            not work correctly. Do not change any of the priority defaults 
  404.            unless you really know what you are doing.  The default 
  405.            priorites have not been plucked from thin air, they are
  406.            the result of years of research in Amiga and AutoCLI 
  407.            programming.  USE WITH CAUTION.
  408.            
  409.         2. If you use a blank screen (no splines) the blanked priority
  410.            is ignored and a priority of zero used.  The AutoCLI task
  411.            is put to sleep in this mode, therefore does not steal any
  412.            time and a lower priority is not required.  The priority you
  413.            set is remembered though, and if you enable splines with the
  414.            option window, your priority will be used.   
  415.              
  416. AUTO WINDOW ACTIVATION
  417. ----------------------             
  418.  
  419. -k      
  420.         This switch enables auto window activation.  If enabled this
  421.         function will activate any window the mouse is currently in 
  422.         when a key is pressed, unless a string gadget is currently active
  423.         in another window.  It will still work even if another screen is
  424.         at the front, and you have dragged it down and placed the mouse 
  425.         over a window on the screen behind.
  426.         
  427. MOUSE MOVEMENT LOCKING & FREEZING
  428. ---------------------------------
  429.  
  430. -l or -lr   
  431.  
  432.         TO TEMPORARILY LOCK X or Y MOVEMENTS
  433.  
  434.         This switch allows the mouse movements to be frozen in vertical,
  435.         horizontal or both directions, by holding down a key or keys.  A
  436.         freeze mouse toggle is also supported.  If the CONTROL key is 
  437.         held down the horizontal movements are frozen.  If the LEFT ALT 
  438.         key is held down then the vertical movements are frozen.  If both 
  439.         are held down then all movements are frozen.  When either of these
  440.         keys are released then movements continue in that direction.
  441.             
  442.         If the CONTROL and LEFT ALT  keys conflict with your first or
  443.         second qualifier keys (see -s -c -a, -f) then use the -lr switch
  444.         instead. The lock keys will change to RIGHT SHIFT for horizontal
  445.         and RIGHT ALT for vertical.  These two modes can be toggled from
  446.         the option window.
  447.         
  448.         TO FREEZE ALL MOVEMENTS OF MOUSE FOR EXTENDED PERIOD
  449.             
  450.         If you want to freeze the entire mouse movements for an extended
  451.         period (EG. Over the start gadget of a copy program etc.) then
  452.         hold down your first qualifier key and press the right mouse 
  453.         button.  This will freeze the mouse permanently until the same
  454.         combination (first qualifier/right mouse) is received again.
  455.         If mouse blanking is enabled, the mouse will still blank while
  456.         frozen.  Moving the mouse will cause it to be re-displayed yet
  457.         no movement will occur.
  458.             
  459.             
  460. MOUSE BLANKING
  461. --------------            
  462.  
  463. -b          
  464.         This switch enables mouse blanking.  When any key is pressed,
  465.         or if no mouse movement is detected within 30 seconds the mouse
  466.         pointer will be blanked.  As soon as the mouse is moved the 
  467.         pointer will be returned immediately.  This overcomes the annoying
  468.         habit of the pointer always being in the way while typing.
  469.  
  470. LEFTY MOUSE
  471. -----------
  472.  
  473. -e          
  474.  
  475.         This switch electrically exchanges the left and right hand buttons
  476.         on the mouse.  All programs that use the mouse correctly will
  477.         work.  If the mouse is checked by hardware then the swap will
  478.         not occur.  This switch can be toggled from the option window.
  479.         
  480. AUTO FORMATTING
  481. ---------------
  482.         
  483. -i<o,f> This switch enables auto disk formatting.  The 'o' option sets
  484.         OLDFS (standard) file system to be used when formatting or the
  485.         'f' option sets it for FastFileSystem (FFS).  If a blank, or non- 
  486.         DOS disk that has its write protect switch set at writeable, is 
  487.         inserted into any drive, a requester will open and ask you if you
  488.         want to format it or leave it.  This formatting will be done in 
  489.         the background, asynchronously to AutoCLI.
  490.         This function requires the standard 'format' command to be
  491.         present in the path.  It has been designed for the standard
  492.         DOS format command, replacement type programs may not work.
  493.         
  494.         EXAMPLES
  495.         
  496.         For old file system -i or -io
  497.         For FastFileSystem  -if
  498.         
  499. QUALIFIER KEY
  500. -------------            
  501. -s  -c  -a  
  502.  
  503.         The default qualifier key is the LEFT AMIGA but this can be 
  504.         changed with a switch.  The -s switch changes the qualifier 
  505.         key to the SHIFT key.  The -c switch changes it to the CONTROL 
  506.         key, and the -a switch changes it to the ALT key.  To use the 
  507.         default key (LEFT AMIGA) then don't use any of these three 
  508.         switches.  Note that this qualifier key is also the same for 
  509.         the autocli function as well.
  510.             
  511. -r          
  512.  
  513.         The above qualifier is, by default, the key on the LEFT side   
  514.         of the keyboard.  To change this to the RIGHT side, use this    
  515.         switch.                 
  516.              
  517. SCREEN BLANKING SECONDS AND SPLINE PATTERNING OPTIONS
  518. -----------------------------------------------------             
  519.              
  520. OPTIONAL SECONDS
  521. ----------------
  522.         
  523.         This is an optional time (in seconds) to blank the screen 
  524.         when no user input is detected. The default is off, so if 
  525.         blanking is not wanted then do not give a time at all.  When 
  526.         the screen has been blanked, it can be turned on again by 
  527.         touching any key, moving the mouse, a disk insertion or a
  528.         disk ejection. This (time) number must be after ALL of the 
  529.         switches including those below that are used in conjunction with 
  530.         this. In other words it must be the last parameter on the line.
  531.         It has been left this way to remain compatible with older versions.
  532.             
  533.         You can blank the screen immediately as if the time had expired 
  534.         by pressing holding your first qualifier key and pressing your
  535.         second qualifier key.
  536.         
  537.         One point to keep in mind is that, if there is a lot of CPU 
  538.         activity while blanked, AutoCLI may take a little while to 
  539.         respond to an event to un-blank depending on the setting of
  540.         blanked priority.  
  541.         
  542.         
  543. SPLINE PATTERNING OPTIONS
  544. -------------------------
  545.  
  546. -l[<a><t><o><s>]<c[n]>  
  547.     
  548.         This switch has a double function with various options.  It is
  549.         used in conjunction with screen blanking.  See 'OPTIONAL SECONDS'
  550.         and -lfb below.  The 'a' part of the switch forces the program
  551.         to randomly change to all spline patterns.  Each time the routine
  552.         finishes drawing your selected number of lines in a certain 
  553.         pattern, it has one chance in twice your chosen number of lines
  554.         of changing patterns.  Sometimes they may change rapidly or 
  555.         slowly.  If you prefer a set pattern, you may use one of the 
  556.         following switch parts instead.  The 't' part of this switch 
  557.         forces the spline pattern to be triangles.  The 'o' part forces 
  558.         open ended triangles and 's' is for single lines.  Try them all 
  559.         and see which your prefer or select random.  Only one of these four
  560.         are allowed, either 'a','t', 'o' or 's' NOT MORE THAN ONE.  If all 
  561.         of these are omitted, a default pattern of boxes will be used.  
  562.         These can also by changed while running in the option window.  At 
  563.         the bottom of the option window is a string gadget containing the 
  564.         number of spline lines to draw.  Your chosen switch part precedes 
  565.         this value within the string gadget and can be modified if you
  566.         wish.  If AutoCLI was launched without one of these switches 
  567.         (default pattern) you may still change patterns by inserting one
  568.         of the switch parts before the value in the string gadget.
  569.         (EG. If gadget had 65, to change to random, gadget would become
  570.         a65 etc.).
  571.           
  572.         The 'c[n]' part of the switch changes the number  of lines the 
  573.         spline patterning routine draws defined by the 'n' portion.  This 
  574.         value can have be between 2 - 100 or 0.  If this switch is not 
  575.         given then a default value of 65 will be used.  If you do not want 
  576.         spline patterning, and prefer a blank black screen when blanked,
  577.         use 0 as the parameter (IE. -lc0 ).  To change the speed of the 
  578.         splines see the -lfb parameter.  If a number too large is given 
  579.         for 'n', it will default to 100, similarly if a number too small
  580.         is given, it will default to 2.
  581.              
  582.         EXAMPLES
  583.         
  584.         -lt    Gives Triangles with default of 65 lines
  585.         -lo    Gives Open sided boxes with default 65 lines
  586.         -ls    Gives Single lines with default of 65 lines
  587.         -la    Gives random changing patterns with default 65 lines
  588.         -lc50  Gives boxes with 50 lines
  589.         -ltc45 Gives triangles with 45 lines
  590.         -loc45 Gives Open sided boxes with 45 lines
  591.         -lsc45 Gives Single lines with 45 lines
  592.         -lac30 Gives random changing patterns with 30 lines
  593.         -lc0   Gives blank black screen
  594.  
  595. -l<f><b>        
  596.  
  597.         This double switch is used in conjunction with screen blanking.
  598.         The switch has two parts the 'f' part and 'b' part.  You may
  599.         use one or both of them. 
  600.         If the 'f' part is given, then the spline patterning will go
  601.         as fast as it will run on your Amiga.  If not given it will be 
  602.         timed to go about the same speed on all Amiga's by using a
  603.         vertical interuppt, and will be slower.
  604.         If the 'b' part is given then the blanking screen will be
  605.         2 bitplanes instead of 1.  2 bitplanes allows more colours
  606.         to be displayed on the spline screen at once.  In 2 bitplane
  607.         mode the routine will use around 120K of chip memory, so 
  608.         only select this mode if you have that amount free.  The memory 
  609.         is only used when the screen is blanked and is given back 
  610.         when un-blanked. 
  611.         1 bitplane mode only allows a single colour to be used at
  612.         one time to draw the splines (although it will cycle to
  613.         different colours).  This requires only half the amount
  614.         of chip memory and should work alright on all Amiga's, unless
  615.         your chip memory usage is very large.
  616.         If you have chosen 2 bitplanes and screen blanking doesn't
  617.         seem to work try removing the 'b', and try again.
  618.             
  619.         EXAMPLE
  620.           
  621.         -lf   speed up splines and use 2 colours        (1 + background)
  622.         -lb   splines timed by VBlank and use 4 colours (3 + background)
  623.         -lfb  speed up splines and use 4 colours        (3 + background)           
  624.                         
  625.  
  626. -x[n]   This switch allows you to specify the initial horizontal 
  627.         co-ordinate of the option window.  The value of [n] must
  628.         be between 0 and (screen width - 536 ).  If an incorrect value
  629.         is given it will be modified to bring the window inside
  630.         the screen area.  If the window is dragged while open, 
  631.         subsequent openings will will be at this new position.
  632.         
  633.         EXAMPLE
  634.         
  635.         -x40  Left edge of the option window is at pixel 40 
  636.         
  637.         For a screen that is 640 pixels wide the maximum number
  638.         would be (screen width - 536) = (640 - 536) = 104
  639.  
  640. -y[n]   This switch allows you to specify the initial vertical 
  641.         co-ordinate of the option window.  The value of [n] must
  642.         be between 0 and (screen height - 133 ).  If an incorrect value
  643.         is given it will be modified to bring the window inside the 
  644.         screen area.  If the window is dragged while open, subsequent 
  645.         openings will will be at this new position.
  646.         
  647.         
  648.         EXAMPLE
  649.         
  650.         -y50  Top edge of the option window is at pixel 50 
  651.         
  652.         For a screen that is 256 pixels high (EG. PAL HighRes) the 
  653.         maximum number would be (screen height - 133) = (256 - 133) = 123
  654.         
  655.         For a screen that is 200 pixels high (EG. NTSC HighRes) the
  656.         maximum number would be (screen height - 133) = (200 - 200) = 67 
  657.         
  658.  
  659. USAGE DISPLAY
  660. -------------
  661.  
  662. ?           
  663.  
  664.         If the only switch is a single question mark, then AutoCLI
  665.         will display a USAGE string on the current CLI window.  
  666.         It will not install or remove itself.
  667.         
  668.         EXAMPLE
  669.         -------
  670.         AutoCLI ?
  671.             
  672.             
  673. REMOVING AutoCLI completely
  674. ---------------------------            
  675. remove      
  676.  
  677.         This switch should be used on its own.  It will signal
  678.         the current version of AutoCLI to shut down and remove 
  679.         itself.  Whenever it attempts this removal, a success
  680.         or failure message will be displayed on the CLI window.
  681.         
  682.         To remove from Workbench, see OPTIONS WINDOW.
  683.  
  684. WARNING WINDOW
  685. --------------
  686.         The event handler constantly checks the restart vectors against
  687.         values that were there when AutoCLI was first launched.  These
  688.         vectors are often modified by viruses in order to survive a
  689.         reboot.  If this happens during normal operation, (IE. file
  690.         virus gets launched) then AutoCLI will open a small warning
  691.         window and ask you if you wish to replace them with their
  692.         original values or leave them.   For example mounting RAD:
  693.         and then accessing it will change these vectors but is of course
  694.         O.K., and not a virus.  You would answer NO to the question, 
  695.         AutoCLI will then accept these changes as OK.
  696.  
  697. OPTIONS WINDOW
  698. --------------
  699.         This function is always available, even if function key scripts
  700.         (-f) is turned off.  It is accessed by holding your first qualifier
  701.         key and pressing HELP.  A window will open on the front most 
  702.         screen with gadgets set with your current options.  This window
  703.         is asynchronous to the main program.  This means that all AutoCLI
  704.         functions will continue to operate if the options window is open.
  705.         Click on the gadgets to turn functions on or off.  Some fuctions
  706.         have more than one setting and each click of its particular 
  707.         gadget will cycle that gadget through all possible modes.  The
  708.         text string beside the gadget will also change to help you 
  709.         remember the function of each particular setting.
  710.         
  711.         The command string that is executed when first qualifier ESC is 
  712.         pressed will be displayed in a string gadget called 'Command 
  713.         String'.  If you are using Auto sizing CLI/Shell windows, this
  714.         string gadget will be ghosted.  To use a modiified string or
  715.         replace it completely, click the 'AUTO' gadget.  The gadget will
  716.         now show 'MANUAL' and the string gadget will be available and be
  717.         selected for your input.  You can always return to Auto sizing by
  718.         re-enabling the 'AUTO' mode.
  719.         
  720.         Screen blanking time can be changed by clicking in the gadget
  721.         and changing it accordingly.  If you turn screen blanking on, but
  722.         give no time, then a default time of 500 seconds will be set.
  723.         
  724.         The number of lines to draw in the spline patterning code can
  725.         be changed by clicking in the gadget and changing it accordingly.
  726.         if an incorrect value is given then the closest correct value will
  727.         immediately appear in the gadget.  A totally incorrect response
  728.         will force a value of 65 to be placed in the gadget.  The type
  729.         of pattern to use (boxes or triangles) is incorporated into this
  730.         gadget.  If you selected triangles or wish to select triangles 
  731.         then a 't' should precede the value. (IE. to show triangles with
  732.         50 lines, this gadget should show t50).
  733.         
  734.         At the bottom of the window are two gadgets, 'OK' and 'REMOVE'.
  735.         The 'OK' gadget closes the options window.  The remove gadget will 
  736.         open a requester and ask you if you are sure you want to remove
  737.         AutoCLI completely.
  738.                 
  739. OPTIONAL COMMAND (command run when 'Qualifer ESC' is pressed)
  740. ----------------
  741.         If no optional command is given then AutoCLI will use a default
  742.         command.  This default command is:-  
  743.         AutoCLI will launch and wait for your qualifier key and ESCAPE to 
  744.         be pressed.  When this event occurs AutoCLI will open a CLI or 
  745.         Shell window 1 pixel less than the size of the WorkBench Screen at
  746.         the time it is opened.  If resolution mode is changed AutoCLI will
  747.         notice the change.  If NEWCON: is available, a Shell window will 
  748.         open instead of a CLI window and if running under V2.0x of 
  749.         Workbench, the window will have a close gadget.    
  750.  
  751.         If an optional command is given, AutoCLI will execute that command
  752.         in preference to the default CLI/SHELL window when your qualifier
  753.         key and ESCAPE is pressed (see EXAMPLES).  This allows custom 
  754.         commands or custom size CLI/Shell windows to be used.  Note that
  755.         if AutoCLI is already in memory it will update itself to to 
  756.         reflect all parmeters given.
  757.         
  758.         The Optional Command can be modified after launch within the option
  759.         window.  Click the gadget beside the 'Command String' string gadget
  760.         until it shows 'MANUAL', the string gadget will be activated for 
  761.         you.  The command can then be modified and the program will use
  762.         this new string.  The default string can always be re-selected by
  763.         clicking the gadget until it shows 'AUTO'. 
  764.  
  765. UPDATING AutoCLI ONCE ALREADY RUNNING
  766. -------------------------------------
  767.         Most changes can be made via the options window, or you can launch
  768.         again from the CLI and supply a whole new set of parameters and it
  769.         will completely update itself.  If launched with a newer version
  770.         this newer version is NOT installed, it will simply supply a new
  771.         set of parameters to the current version.
  772.  
  773.  
  774. COMMAND LINE EXAMPLES  
  775. ---------------------  
  776.  AutoCLI
  777.         
  778.         Attempts to load a file 'S:autocli.cmd' and reads it for the 
  779.         options.
  780.  
  781.  AutoCLI -frd -io -d -w -n -b -q2 -m -k -l -lfb -ltc50 600 
  782.         
  783.         Opens a Shell window with automatic full size minus 1 pixel.
  784.         Enables 20 function keys with RIGHT AMIGA as the qualifier for the
  785.         second 10.  Selects the LEFT AMIGA as your qualifier.  Enables auto
  786.         disk formatting with OLDFS (normal), enables double-click to front
  787.         windows, key-window to front option, screen shuffle option, window 
  788.         shuffle option, pointer lock, auto window activation, mouse blanking,
  789.         mouse acceleration at the second rate, screen blanking after 10 mins
  790.         of non use, and draws triangles with 50 spline patterning lines,
  791.         using 4 colours in fast mode. 
  792.      
  793.  AutoCLI -f -w0 -n -m -k -l -r -s -pb-5 600 newshell newcon:0/10/640/150/MyShell
  794.  
  795.         Opens a Shell window with a title of 'MyShell', enables function 
  796.         keys, selects the RIGHT SHIFT (-r -s) as your qualifier and right 
  797.         Amiga as the second qualifier (-f), enables the window to front 
  798.         option ,enables the screen shuffle option, enables the window shuffle,
  799.         enables pointer lock, enables auto activation, changes the blanked 
  800.         priority to -5, and will blank the screen after 10 mins of non use). 
  801.  
  802.  AutoCLI -f -d -q2 YourProg
  803.         Runs a file called YourProg when LEFT AMIGA/ESCAPE is pressed,
  804.         enables function keys, double-click window to front and will disable 
  805.         the screen blanking (ie. no time given), and will accellerate the 
  806.         mouse by a factor of 4. 
  807.                                
  808.  AutoCLI remove
  809.  
  810.         Attempts to remove the currently running version from memory
  811.         and displays a success or failure message).
  812.  
  813. REQUIREMENTS
  814. ------------
  815. The following commands MUST be available in the current C: directory
  816. for kickstart 1.3.  With V2.04, some may be resident commands.
  817.    
  818. execute         ; c directoey (called by the DOS Execute function)
  819. run             ; c directory (called by the DOS Execute function)
  820. newcli          ; c directory (called by AutoCLI if NEWCON not available)
  821. newshell        ; c directory (called by AutoCLI if NEWCON is available)
  822. shell-seg       ; l directory (needed if NEWCON: is mounted)
  823. AutoCLI         ; c directory or current directory when launched.
  824.  
  825. The following commands, devices, files are optional :-
  826.  
  827. cli-startup     ; s directory (script executed by Newcli)
  828. shell-startup   ; s directory (script executed by NewShell)
  829. NEWCON:         ; (must be mounted to enable Shell instead of CLI)
  830. AutoCLI.f1      ; s directory (script file for qualifier/F1)
  831. AutoCLI.f2      ; s directory (script file for qualifier/F2)
  832. ...etc.
  833. AutoCLI.e1      ; s directory (script file for 2nd qualifier/F1)
  834. AutoCLI.e2      ; s directory (script file for 2nd qualifier/F2)
  835. ...etc.
  836.  
  837. NOTE: 'Amiga','Workbench' & 'Kickstart' are Trademarks of Commodore 
  838. Amiga Inc.
  839.  
  840.       
  841.  
  842.                     
  843.