AutoCLI V1.6 17th June 1990 by Nic Wilson
            -----------------------------------------
  	            
This program has been placed on the Public Domain for your enjoyment. 
Permission is hereby given to distribute this program in any 
way you see fit, as long as this doc file accompanies it.
Please send any bug reports or ideas (and spare money) to the
address at the bottom of this file.

Commercial companies may also distribute the program, as long
as the program is free of charge and all files accompany it.

PROGRAM SUMMARY
---------------
This program was written because of problems with the similar
program I have been using called 'popcli'.  Popcli crashes if used
under WorkBench/KickStart 2.0, and also if used on a PAL Amiga to
open a CLI window with a vertical size greater than 200 lines, it
will not open if your Amiga decides to start in NTSC mode as they
sometimes do,  Popcli also seems to steal CPU time when waiting and
doesn't allow you to remove it from memory without crashing or a 
reboot. AutoCLI overcomes all of the above problems and was written 
in 100% Assembler using Devpac Amiga V2.14.
The program is very quick, as hand coded assembler is definately
the best way to program.  The code is very small and executes very 
fast as compared to coding in 'C' or other language, as the code 
generated would be much larger and slower. 

PROGRAM USAGE FOR INSTALLING AutoCLI
------------------------------------
AutoCLI [<optional switches>] [<optional command>]

It DOES NOT require RUN or RUNBACK as it will return the command
line and allow the window it was launched from to close, when an
ENDCLI command is given.

The program is mainly be designed to be used in your startup-sequence
so you will always have a CLI window available very easily.  For best
results place the program in your C: directory

OPTIONAL SWITCHES
-----------------
-f          This switch enables function key trapping.  Default is OFF but
    	    if the -f switch is found then it is turned on.  When the 
    	    qualifier (see below) is held down and a function key pressed 
    	    the program will execute a script file in the assigned S: 
    	    directory with a filename of AutoCLI.F1, AutoCLI.F2 etc.
    	    This file must be a standard script file (eg startup-sequence).
    
-s  -c  -a  The default qualifier key is the LEFT AMIGA but this can be 
            changed with a switch.  The -s switch changes the qualifier 
            key to the SHIFT key, The -c switch changes it to the CONTROL 
            key and the -a switch changes it to the ALT key.  To use the 
            default key (LEFT AMIGA) then don't use any of these three 
            switches.  Note that this qualifier key is also the same for 
            the autocli function aswell.
            
-r	    The above qualifier is, by default, the key on the LEFT side
	    of the keyboard.  to change this to the RIGHT side, use this
	    switch.                  

?	    If the switch is a single question mark, then AutoCLI
	    will display a USAGE string on the current CLI window.  
	    It will not install or remove itself.
	    
	    
OPTIONAL COMMAND
----------------
If no optional command is given then AutoCLI will use a default command.
If AutoCLI is already in memory it will be removed and all parameters
will be ignored.  If AutoCLI is not in memory then it will launch and 
wait for the qualifier key and ESCAPE to be pressed.  When this event 
occurs AutoCLI will open a CLI window 1 pixel less than the size of the 
WorkBench Screen, allowing the WorkBench window to be more easily 
selected without having to resize the window.  If NEWCON: is available, 
then a Shell window will open instead of a CLI window.

If an optional command is given, then AutoCLI will execute that command
in preference to the default command when the qualifier key and ESCAPE is
pressed (see EXAMPLES).  This allows custom commands or custom size 
CLI/Shell windows to be used, but note that if AutoCLI is already 
in memory it will ignore the optional command and remove AutoCLI from 
memory.

Whenever AutoCLI is removed from memory, a message to that effect will
be displayed on the current CLI window.

EXAMPLE  
	AutoCLI -f -r -s newshell newcon:0/10/640/150/MyShellWindow
	(opens a Shell window with a title of 'MyShellWindow', enables
	function keys, and selects the RIGHT SHIFT as the qualifier).
	
	AutoCLI -f
	(opens the default window with a title of 'AutoCLI V1.6'
	 and enables function keys.  The qualifer will be the 
	 default of LEFT AMIGA)
			       OR
	(if already installed it will be removed (switch ignored))			       

NOTE:  The command can of course be any executable file that
       is normally used from CLI, it does not have to be used 
       to open CLI windows, but can be used to launch any
       program you wish.

REQUIREMENTS
------------
The following commands MUST be available in the current C: directory         

run		;c directory (called by the DOS Execute function)
newcli 		;c directory (called by AutoCLI if NEWCON not available)
newshell	;c directory (called by AutoCLI if NEWCON is available)
AutoCLI		;c directory

The following commands, devices, files are optional

cli-startup	;s directory (script executed by Newcli)
shell-startup   ;s directory (script executed by NewShell)
NEWCON:		;(must be mounted to enable Shell instead of CLI)
AutoCLI.F1	;s directory (script file for qualifier/F1)
AutoCLI.F2	;s directory (script file for qualifier/F2)
etc

Nic Wilson Software
138d South Street
TOOWOOMBA Queensland 4350
Australia

Phone (076) 358539  Home
      (076) 358522  Work
      (076) 358522  Fax