4]------------- 3]AUTOCLI V1.73 3]By Nic Wilson 4]------------- The program is mainly designed to be used in your startup-sequence so you will always have a CLI window available very easily. For best results, it should reside in your bootdisk's C: directory. 3]FEATURES AUTOCLI is compatible with Kickstart Workbench 1.2, 1.3 and 2.0, as well as the A500, A1000, A2000, A2500 and A3000. It creates default or custom CLI/Shell windows of a size up to one pixel less than the current screen, and default windows open to just that size. Features include function key scripts option, active window to front option, screen shuffle option, window shuffle option, screen blanking after time period option, mouse blanking on key press or time option, mouse acceleration option, no CPU time waste and 100% machine code 3]PROGRAM USAGE FOR INSTALLING AutoCLI AutoCLI [] [] [] It DOES NOT require RUN or RUNBACK, as it will return the command line and allow the window from which launched to close with an ENDCLI command. Yet, it retains the directory from which launched and does not lose the current path or stack, as some programs do. This means when a CLI is popped up it will default to the directory that was current when AutoCLI was launched. The path and stack set will still be valid. 3]OPTIONAL SWITCHES The following switches do not have to be given in any particular order. All options default to OFF and must be enabled with a switch. -f --Enables function key trapping. When your 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 normal script, such as a startup-sequence). -w --Enables the window-to-front option. To use it, select the window you want at the front by clicking the left mouse inside the window, press your qualifier key (see below) and press the Left ALT key. -n --Screen shuffle option. Hold down your qualifier key and use the cursor up or down keys. These keys rotate all screens in opposite directions to each other. This is different from the standard LEFT-AMIGA-N and -M. These standard keys only swap between the front and rear most screens. -m --Window shuffle option. Hold down the qualifier key and use the cursor left or right keys. This will respectively move the front window to the back or the back most window to the front. The window shuffle always occurs on the screen that is at the front. This lets you to easily move between windows and screens by using the qualifier and all the cursor keys -q --Mouse acceleration, If you find that it is too fast, slow it down in Preferences. The amount it speeds the mouse depends on the speed the mouse is being moved. As it moves quicker the acceleration rate increases and slows as acceleration rate decreases. -b --Mouse blanking. When any key is pressed the mouse pointer will be immediately blanked. If no mouse movement is detected within 30 seconds, the mouse pointer will be blanked. As soon as the mouse is moved at all the pointer is returned immediately. This overcomes the annoying habit of the pointer always being in the way while typing. -s -c -a --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), don't use any of these three switches. This qualifier key is also the same for the AUTOCLI function as well. -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, AUTOCLI will display a USAGE string on the current CLI window. It will not install or remove itself. REMOVE --This switch should be used on its own. It will signal the current version of AUTOCLI to shut down and remove itself. When it attempts this removal, a success or failure message is displayed on the CLI window. 3]OPTIONAL SECONDS This is an optional time in seconds to blank the screen when no user input is detected. The default is off, so if blanking is not wanted, do not give a time at all. When the screen has been blanked, it can be turned on again by touching any key or moving the mouse. Because it only requires a single rawmouse event, we have found that giving your computer table a nudge is sufficient to turn the display on again. 3]OPTIONAL COMMAND If no optional command is given, AUTOCLI will use a default command. It will launch and wait for your qualifier key and ESCAPE to be pressed. When this event occurs, it opens a CLI window 1 pixel less than the size of the WorkBench screen at the time it is opened. So if resolution mode is changed, AUTOCLI will notice the change. If NEWCON: is available, a Shell window will open rather than a CLI window. If an optional command is given, AutoCLI will execute it in preference to the default CLI/SHELL window when your qualifier key and ESCAPE are pressed. (See EXAMPLES). This allows custom commands or custom size CLI/Shell windows to be used. If AUTOCLI is already in memory it will display an error message on the current CLI window. 3]EXAMPLES AutoCLI -f -w -n -m -r -s 600 newshell newcon:0/10/640/150/MyShell Opens a Shell window with a title of "MyShell", enables function keys, selects the RIGHT SHIFT as qualifier, enables the window to front option, enables the screen shuffle option, enables the window shuffle and will blank the screen after 10 minutes of inactivity. AutoCLI -f -w YourProg Runs a file called YourProg. When LEFT AMIGA/ESCAPE is pressed, enables function keys and window to front and disables the screen blanking by giving no time. AutoCLI remove Attempts to remove the currently running version from memory and displays a success or failure message). 3]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) shell-seg - L directory (needed if NEWCON: is mounted) 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) 3]KNOWN BUGS OR CONFLICTS Problems have been encountered with non-standard versions of the RUN command. This command is called by dos.library's EXECUTE command. If you have problems with the Amiga crashing when a CLI is popped up, then make sure the RUN command is standard. The one I use came from an original Workbench 1.3.2 and has a file size of 2568 bytes. Mouse blanking sometimes leaves a vertical bar on the screen, though I've tried waiting for Vertical Blank before turning off Sprite DMA. Anyone know why? 3]AUTHOR We at Nic Wilson Software not only write commercial programs, but non-commercial too. If you like this program and use it, help us by sending a donation to the address below. Nic Wilson Software 138d South St. TOOWOOMBA Queensland 4350 Australia Phone (076) 358539 Home, (076) 358522 work or FAX. 4]END OF TEXT