---------------------------------------------------------------------------
ReadMe file for RMA/CLI Front End by  ACHSoft 1993.
---------------------------------------------------------------------------

 Introduction:
 -------------
 !MACE is the rather naff acronym for Module Area & Cli front End. It allows
the user to manage the RMA from the desktop, providing control over the individual, modules present in memory. !MACE provides a WIMP front end to
the Command Line allowing *Commands to be executed from the desktop without
having to press F12. This is far more convenient for the occasional CLI user.

 The CLI Front End:
 ------------------
 Click SELECT over the !MACE *Command  icon to display the CLI front end
(This looks like a function key with a blue asterisk printed on it). Enter
the *Command name into the first writeable field or choose one from the menu list provided (Click SELECT over the arrow icon). Then enter any additional 
parameters into the second field. To execute the *Command click on one of the
action icons as described below:

 HELP- provides more information on the given *Command including it's 
       function and syntax.

 SHOW FKEYS- displays the Function Key window allowing *Commands to be linked
             to a function key.

 EXECUTE- for any other type of *Command.

 *Commands which perform an action on a specific file or directory (e.g. *Dir
& *SetType) can be executed in the following way:

 * Enter the *Command into the first field.

 * Enter any additional parameters (not the filename!) into the second field
   (e.g. the filetype in the case of *SetType)

 * Drag the desired file to the !MACE icon to perform the *Command on it.

 Function Key Settings:
 ----------------------
 Although !MACE includes some example commands already stored you may wish to
retain several of your most commonly used commands and trigger them without
the need to enter them into the CLI Front end each time.
 
 !MACE provides a desktop means of doing this as follows:

 * Click SELECT on the 'Show Fkeys' icon to display the 'Function Key Window'.

 * Enter the *Command into the first field.

 * Enter any additional parameters into the second field.

 * Click SELECT over the desired 'function key' icon to store.

 * Press the equivalent function key to trigger the *Command.

 Application Launching:
 ----------------------
 !MACE can also be used as an application launcher. Dragging an application 
onto a 'function key' icon will link it to that function key. The application
can then be launched by hitting that function key. This will override any 
previous *Commands which may have been linked to that key.

 Saving your Settings:
 ---------------------
 The current Function Key settings can be saved to disk as the default settings.
These will then be recalled each time you load !MACE. To save, choose the
'Save Setup' item from the iconbar menu. 

 The Keypress Trap:
 ------------------
 Usually, !MACE will respond to all keypresses no matter which application 
(if any) has the input focus. This can be annoying if you want to use the 
key-shortcuts in a program like !Impression without triggering a *Command
or an application you may have stored. So, for convenience, the keypress
trap can be turned on or off via the 'Keypresses' subwindow located on the iconbar menu.

 Module Controller:
 ------------------
 The various options for controlling modules are available by Clicking SELECT on !MACE's Module icon. Enter the module name into the writeable field and Click MENU to select the desired option:

 UNPLUG- stops the given ROM module being initialised.

 INITIALISE- reinitialises a relocatable module, reversing the action of Unplug 
             if appropriate.

 KILL- kills and deletes a relocatable module.

 ROM>RAM- moves a module from ROM to RAM.

 SHOW INFO- provides additional information on the given module including
            version number and any *Commands available.

 Managing the RMA:
 -----------------
 The more generalised facilities for RMA control are available directly from
the iconbar sunbmenu 'RMA':

 ROM MODULES- provides a full list of the ROM-based modules installed in the
              machine.

 RAM MODULES- provides a full list of all current modules present in the RMA.

 TIDY UP- compacts the RMA and reinitialises all the modules.

 CLEAR ALL- deletes all relocatable modules from the RMA.

 Installing New Modules:
 -----------------------
 Relocatable Modules are usually installed by Double-Clicking on them in a
filer window. However, this will not only install the new module but RUN it
as well. So, a module such as !65Tube will automatically enter BBC mode. What
do you do if you just wanted to have the module present for use at a later
date? Well, dragging a module to !MACE's Module icon will install it without
running it as well. 

 Final Note:
 -----------
 Some of these facilities may have drastic effects such as deleting modules
which are required by programs may cause them to crash. !MACE itself requires
CLib 3.75 & Interface 1.25 to be constantly in memory so if you must 'Clear'
the RMA then please reload these modules before using !MACE again. Finally,
I cannot be held responsible for any crashes that may occur while using !MACE
nor can I be held responsible for any buggered-up Module Areas!
 
 
                                                  Andrew Heckford 1993
