home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Fish 'n' More 2
/
fishmore-publicdomainlibraryvol.ii1991xetec.iso
/
fish
/
enhancements
/
general
/
autocli_399
/
autocli.doc
< prev
next >
Wrap
Text File
|
1990-11-02
|
6KB
|
135 lines
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