Home » Archimedes archive » Archimedes World » AW-1993-02.adf » AWFeb93 » !AWFeb93/Goodies/ModuleFS/!Help

!AWFeb93/Goodies/ModuleFS/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Archimedes World » AW-1993-02.adf » AWFeb93
Filename: !AWFeb93/Goodies/ModuleFS/!Help
Read OK:
File size: 260E bytes
Load address: 0000
Exec address: 0000
File contents
                               Module FS

         A psuedo filing system for the Relocatable Module Area

                      Author - Liam Corner  1992
                       
                      (C) Archimedes World 1992


Module FS provides easy desktop access to the contents of the RMA. 
The program has 3 main functions :

1) Displays the modules residing in the RMA in a filer like window
   allowing them to be unplugged, reactivated etc.
2) Displays full information about a module, its SWI calls and its
   *commands 
3) Allows modules to be saved from the RMA to a standard editor/filer
   window

Module FS is installed by double clicking on the icon.  The icon will
appear on the right hand side of the icon bar and the main window will
open.  Only one copy of Module FS may be active at any one time.

1) Module FS filer window
-------------------------

The main Module FS window is an imitation of a standard filer window, but
there are a few differences.  The modules are represented as icons and a
name, as they would be in a normal filer window.  The name that they are
given is the module title, which is not necessarily the same as the module's
filename.  The modules which are permanently resident in the machine (ROM
modules) are displyed in the top section of the window, whilst those loaded
into the machine are displyed in the lower section.  A module can be in one
of four states : unplugged, dormant, active or running.  Each state has a
different icon and the text may be highlighted (see section on Options). 
The four states of a module are viewed as separate by the program, so for
example selecting an unplugged icon will only deselect other unplugged
icons, not active, running or dormant ones.
If any changes have taken place in the RMA since the program last read the
contents, then a * is appended to the title bar. Clicking the middle button
over the window produces the following menu options:


Display =>  Large icons
            Small icons
            Full info

This works in the same way that a filer window works.  The 'Full info'
display provides the information :
short title    long title    version and date    size


Selection =>   RMFaster
               RMReInit
               Unplug
               --------
               RMKill

These commands are fully documented in the Risc OS User Guide.  If only one
module is selected the its title will be displayed in the menu.  The
commands available in the submenu may be greyed out if they cannot be
applied to the particular module selected, eg you cannot unplug a RAM
module. If a number of modules are selected, then all commands will be
available from the menu, but will only be performed on those modules to
which the command is meaningful.  The commands may be applied as follows :

ROM modules
            Unplug   Dormant  Active   Running
RMFaster    no       no       yes      yes
RMReInit    yes      yes      yes      yes
Unplug      no       yes      yes      yes
RMKill      no       no       yes      no

RAM modules
            Active   Running
RMFaster    no       no
RMReInit    yes      yes
Unplug      no       no
RMKill      yes      no

NB some actions will have no effect on some modules eg RMReInit will have no
effect on a dormant Econet module unless there is Econet hardware present in
the machine.

WARNING - use of RMKill and Unplug can cause the Desktop to become unusable,
produce frequent errors or even freeze up if the wrong modules are affected
(you will probably require R-PowerOn to remedy this - see relevant section
in Risc OS guide).  It is not a good idea to use these commands on the ROM
modules unless you know what you are doing.


Select all =>        Unplugged
                     Dormant
                     Active
                     Running

Clear selection =>   Unplugged
                     Dormant
                     Active
                     Running

When the main menu item is clicked on, these act in the same way as a normal
filer.  The sub-menus allow a particular group of modules to be selected or
deselected.


Options - see later section


Module area => RMClear
               Minimise
               RMTidy

These options apply to the whole module area.  RMClear and RMTidy are
documented in the Risc OS guide.  Minimise reduces the free space in the RMA
to a minimum - the same effect as is achieved by dragging the RMA size bar
to the left in the task display window.  Since RMTidy has a nasty habit of
eating the desktop environment, it is not actually possible to select this
item at the moment.


Update

This rereads the modules contained in the RMA and redraws the window.  If
the title bar showed a *, then this is removed.


2) Module information window
----------------------------

The module information window gives a detailed breakdown of the facilities
provided by a particular module.  To open the window for a module, double
click on the module in the filer display window.  Double clicking with
adjust causes the filer window to be closed before the information window is
opened.  Conversely, clicking on the information window's close icon with
adjust causes the filer window to be reopened.  If, at any time, the module
about which the window contains information is moved or erased from the RMA,
then the information window closes.  Only one information window may be open
at any time.
The window should be fairly self explanatory to anyone who understands the
internals of a module.  Very basically the window gives a list of important
locations within a module and also a list of the *commands and SWI/SYS calls
that it supports.  All numbers are hex except for the size.


2a) Command information window
------------------------------

This window works in the same way that the module information window does,
except that it gives information about a particular *command.  The window is
opened by clicking on one of the *commands in the module information window. 
Again, using adjust will close/open the parent window.
The addresses are in hex, the parameter parameters (?) are decimal and the
GSTrans and flags are binary.  The window also attempts to display the help
and syntax strings for the command.  If the help text is produced by a
section of code (eg *Help Modules), then the help text is not included in
the window as it could become very large indeed.


3) Saving modules
-----------------

Modules, or groups of modules, can be saved to a filer or editor by dragging
them in a similar way to a normal filer window.  Note that all multiple
drags must be performed with the adjust button.  If a group of files are
dragged onto an application rather than a filer window, then only the first
one in the group will be transferred.  Because it is possible for a module
title to exceed the ten character filename limit, long filenames are reduced
by removing vowels.  This is better at avoiding filename clashes than a
simple truncation and is usually perfectly understandable.  Once saved, the
filenames can be altered at will.


4) Options window
-----------------

The options window is opened by selecting 'Options' from either the main
window's menu or the iconbar menu.
The first section deals with the colour of highlight used for each of the
four groups of modules.  It is not necessary to have different groups
highlighted, since they are indicated by different icons, but it it easier
to spot the coloured text than the icon (in my opinion anyway).  To change a
colour, press the menu button over one of the coloured boxes and a standard
colour menu will appear.
The next section deals with when the screen display should be updated. 
Whatever happens, updates will only occur when the window is open, never
closed.  If the window is closed and an update is required, then it will
take place when the window is next opened.  The program monitors all
operations performed on the RMA, even those by other programs.  An update
will ALWAYS be scheduled if a module is RMKilled or Unplugged.  All other
RMA operations are controlled by the options window.  If the update is set
to automatic, then the display will be scheduled for update every time an
RMA operation occurs.  If the setting is manual then the program will beep
and a * will be appended to the title bar of the main window.  The user is
then responsible for updating the display by choosing the 'Update' option
from the menu.
The final section controls the display of addresses in the module and
command information windows.  Absolute causes the addresses to be specified
as the actual memory address.  Relative causes the addresses to be displayed
as an offset from the start address of the module in memory.
The buttons at the bottom of the options window effect the way in which the
options are applied.  Cancel ignores any changes made to the settings.  OK
applies the settings to the current session.  Save will apply the settings
and also save them in the application's defaults file along with the current
setting of display size.  This file is read whenever the application is
started.  Default will apply the default settings which are hardwired into
the program - not those which are stored in the defaults file.


Short technical note
--------------------

This application intercepts the hardware SWI vector in order to monitor
OS_Module SWI calls.  This may cause problems if another application
attempts to do a similar thing.  This is not really my fault, but is due to
Acorn making SWI a hardware, rather than software vector (I think).


Warning:

This program can unplug modules that you may require to run certain 
applications, or programs, so be very careful when using this program as
we cannot be held responsable for any errors you make.

00000000  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00000010  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000020  4d 6f 64 75 6c 65 20 46  53 0a 0a 20 20 20 20 20  |Module FS..     |
00000030  20 20 20 20 41 20 70 73  75 65 64 6f 20 66 69 6c  |    A psuedo fil|
00000040  69 6e 67 20 73 79 73 74  65 6d 20 66 6f 72 20 74  |ing system for t|
00000050  68 65 20 52 65 6c 6f 63  61 74 61 62 6c 65 20 4d  |he Relocatable M|
00000060  6f 64 75 6c 65 20 41 72  65 61 0a 0a 20 20 20 20  |odule Area..    |
00000070  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000080  20 20 41 75 74 68 6f 72  20 2d 20 4c 69 61 6d 20  |  Author - Liam |
00000090  43 6f 72 6e 65 72 20 20  31 39 39 32 0a 20 20 20  |Corner  1992.   |
000000a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000000b0  20 20 20 20 0a 20 20 20  20 20 20 20 20 20 20 20  |    .           |
000000c0  20 20 20 20 20 20 20 20  20 20 20 28 43 29 20 41  |           (C) A|
000000d0  72 63 68 69 6d 65 64 65  73 20 57 6f 72 6c 64 20  |rchimedes World |
000000e0  31 39 39 32 0a 0a 0a 4d  6f 64 75 6c 65 20 46 53  |1992...Module FS|
000000f0  20 70 72 6f 76 69 64 65  73 20 65 61 73 79 20 64  | provides easy d|
00000100  65 73 6b 74 6f 70 20 61  63 63 65 73 73 20 74 6f  |esktop access to|
00000110  20 74 68 65 20 63 6f 6e  74 65 6e 74 73 20 6f 66  | the contents of|
00000120  20 74 68 65 20 52 4d 41  2e 20 0a 54 68 65 20 70  | the RMA. .The p|
00000130  72 6f 67 72 61 6d 20 68  61 73 20 33 20 6d 61 69  |rogram has 3 mai|
00000140  6e 20 66 75 6e 63 74 69  6f 6e 73 20 3a 0a 0a 31  |n functions :..1|
00000150  29 20 44 69 73 70 6c 61  79 73 20 74 68 65 20 6d  |) Displays the m|
00000160  6f 64 75 6c 65 73 20 72  65 73 69 64 69 6e 67 20  |odules residing |
00000170  69 6e 20 74 68 65 20 52  4d 41 20 69 6e 20 61 20  |in the RMA in a |
00000180  66 69 6c 65 72 20 6c 69  6b 65 20 77 69 6e 64 6f  |filer like windo|
00000190  77 0a 20 20 20 61 6c 6c  6f 77 69 6e 67 20 74 68  |w.   allowing th|
000001a0  65 6d 20 74 6f 20 62 65  20 75 6e 70 6c 75 67 67  |em to be unplugg|
000001b0  65 64 2c 20 72 65 61 63  74 69 76 61 74 65 64 20  |ed, reactivated |
000001c0  65 74 63 2e 0a 32 29 20  44 69 73 70 6c 61 79 73  |etc..2) Displays|
000001d0  20 66 75 6c 6c 20 69 6e  66 6f 72 6d 61 74 69 6f  | full informatio|
000001e0  6e 20 61 62 6f 75 74 20  61 20 6d 6f 64 75 6c 65  |n about a module|
000001f0  2c 20 69 74 73 20 53 57  49 20 63 61 6c 6c 73 20  |, its SWI calls |
00000200  61 6e 64 20 69 74 73 0a  20 20 20 2a 63 6f 6d 6d  |and its.   *comm|
00000210  61 6e 64 73 20 0a 33 29  20 41 6c 6c 6f 77 73 20  |ands .3) Allows |
00000220  6d 6f 64 75 6c 65 73 20  74 6f 20 62 65 20 73 61  |modules to be sa|
00000230  76 65 64 20 66 72 6f 6d  20 74 68 65 20 52 4d 41  |ved from the RMA|
00000240  20 74 6f 20 61 20 73 74  61 6e 64 61 72 64 20 65  | to a standard e|
00000250  64 69 74 6f 72 2f 66 69  6c 65 72 0a 20 20 20 77  |ditor/filer.   w|
00000260  69 6e 64 6f 77 0a 0a 4d  6f 64 75 6c 65 20 46 53  |indow..Module FS|
00000270  20 69 73 20 69 6e 73 74  61 6c 6c 65 64 20 62 79  | is installed by|
00000280  20 64 6f 75 62 6c 65 20  63 6c 69 63 6b 69 6e 67  | double clicking|
00000290  20 6f 6e 20 74 68 65 20  69 63 6f 6e 2e 20 20 54  | on the icon.  T|
000002a0  68 65 20 69 63 6f 6e 20  77 69 6c 6c 0a 61 70 70  |he icon will.app|
000002b0  65 61 72 20 6f 6e 20 74  68 65 20 72 69 67 68 74  |ear on the right|
000002c0  20 68 61 6e 64 20 73 69  64 65 20 6f 66 20 74 68  | hand side of th|
000002d0  65 20 69 63 6f 6e 20 62  61 72 20 61 6e 64 20 74  |e icon bar and t|
000002e0  68 65 20 6d 61 69 6e 20  77 69 6e 64 6f 77 20 77  |he main window w|
000002f0  69 6c 6c 0a 6f 70 65 6e  2e 20 20 4f 6e 6c 79 20  |ill.open.  Only |
00000300  6f 6e 65 20 63 6f 70 79  20 6f 66 20 4d 6f 64 75  |one copy of Modu|
00000310  6c 65 20 46 53 20 6d 61  79 20 62 65 20 61 63 74  |le FS may be act|
00000320  69 76 65 20 61 74 20 61  6e 79 20 6f 6e 65 20 74  |ive at any one t|
00000330  69 6d 65 2e 0a 0a 31 29  20 4d 6f 64 75 6c 65 20  |ime...1) Module |
00000340  46 53 20 66 69 6c 65 72  20 77 69 6e 64 6f 77 0a  |FS filer window.|
00000350  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00000360  2d 2d 2d 2d 2d 2d 2d 2d  2d 0a 0a 54 68 65 20 6d  |---------..The m|
00000370  61 69 6e 20 4d 6f 64 75  6c 65 20 46 53 20 77 69  |ain Module FS wi|
00000380  6e 64 6f 77 20 69 73 20  61 6e 20 69 6d 69 74 61  |ndow is an imita|
00000390  74 69 6f 6e 20 6f 66 20  61 20 73 74 61 6e 64 61  |tion of a standa|
000003a0  72 64 20 66 69 6c 65 72  20 77 69 6e 64 6f 77 2c  |rd filer window,|
000003b0  20 62 75 74 0a 74 68 65  72 65 20 61 72 65 20 61  | but.there are a|
000003c0  20 66 65 77 20 64 69 66  66 65 72 65 6e 63 65 73  | few differences|
000003d0  2e 20 20 54 68 65 20 6d  6f 64 75 6c 65 73 20 61  |.  The modules a|
000003e0  72 65 20 72 65 70 72 65  73 65 6e 74 65 64 20 61  |re represented a|
000003f0  73 20 69 63 6f 6e 73 20  61 6e 64 20 61 0a 6e 61  |s icons and a.na|
00000400  6d 65 2c 20 61 73 20 74  68 65 79 20 77 6f 75 6c  |me, as they woul|
00000410  64 20 62 65 20 69 6e 20  61 20 6e 6f 72 6d 61 6c  |d be in a normal|
00000420  20 66 69 6c 65 72 20 77  69 6e 64 6f 77 2e 20 20  | filer window.  |
00000430  54 68 65 20 6e 61 6d 65  20 74 68 61 74 20 74 68  |The name that th|
00000440  65 79 20 61 72 65 0a 67  69 76 65 6e 20 69 73 20  |ey are.given is |
00000450  74 68 65 20 6d 6f 64 75  6c 65 20 74 69 74 6c 65  |the module title|
00000460  2c 20 77 68 69 63 68 20  69 73 20 6e 6f 74 20 6e  |, which is not n|
00000470  65 63 65 73 73 61 72 69  6c 79 20 74 68 65 20 73  |ecessarily the s|
00000480  61 6d 65 20 61 73 20 74  68 65 20 6d 6f 64 75 6c  |ame as the modul|
00000490  65 27 73 0a 66 69 6c 65  6e 61 6d 65 2e 20 20 54  |e's.filename.  T|
000004a0  68 65 20 6d 6f 64 75 6c  65 73 20 77 68 69 63 68  |he modules which|
000004b0  20 61 72 65 20 70 65 72  6d 61 6e 65 6e 74 6c 79  | are permanently|
000004c0  20 72 65 73 69 64 65 6e  74 20 69 6e 20 74 68 65  | resident in the|
000004d0  20 6d 61 63 68 69 6e 65  20 28 52 4f 4d 0a 6d 6f  | machine (ROM.mo|
000004e0  64 75 6c 65 73 29 20 61  72 65 20 64 69 73 70 6c  |dules) are displ|
000004f0  79 65 64 20 69 6e 20 74  68 65 20 74 6f 70 20 73  |yed in the top s|
00000500  65 63 74 69 6f 6e 20 6f  66 20 74 68 65 20 77 69  |ection of the wi|
00000510  6e 64 6f 77 2c 20 77 68  69 6c 73 74 20 74 68 6f  |ndow, whilst tho|
00000520  73 65 20 6c 6f 61 64 65  64 0a 69 6e 74 6f 20 74  |se loaded.into t|
00000530  68 65 20 6d 61 63 68 69  6e 65 20 61 72 65 20 64  |he machine are d|
00000540  69 73 70 6c 79 65 64 20  69 6e 20 74 68 65 20 6c  |isplyed in the l|
00000550  6f 77 65 72 20 73 65 63  74 69 6f 6e 2e 20 20 41  |ower section.  A|
00000560  20 6d 6f 64 75 6c 65 20  63 61 6e 20 62 65 20 69  | module can be i|
00000570  6e 20 6f 6e 65 0a 6f 66  20 66 6f 75 72 20 73 74  |n one.of four st|
00000580  61 74 65 73 20 3a 20 75  6e 70 6c 75 67 67 65 64  |ates : unplugged|
00000590  2c 20 64 6f 72 6d 61 6e  74 2c 20 61 63 74 69 76  |, dormant, activ|
000005a0  65 20 6f 72 20 72 75 6e  6e 69 6e 67 2e 20 20 45  |e or running.  E|
000005b0  61 63 68 20 73 74 61 74  65 20 68 61 73 20 61 0a  |ach state has a.|
000005c0  64 69 66 66 65 72 65 6e  74 20 69 63 6f 6e 20 61  |different icon a|
000005d0  6e 64 20 74 68 65 20 74  65 78 74 20 6d 61 79 20  |nd the text may |
000005e0  62 65 20 68 69 67 68 6c  69 67 68 74 65 64 20 28  |be highlighted (|
000005f0  73 65 65 20 73 65 63 74  69 6f 6e 20 6f 6e 20 4f  |see section on O|
00000600  70 74 69 6f 6e 73 29 2e  20 0a 54 68 65 20 66 6f  |ptions). .The fo|
00000610  75 72 20 73 74 61 74 65  73 20 6f 66 20 61 20 6d  |ur states of a m|
00000620  6f 64 75 6c 65 20 61 72  65 20 76 69 65 77 65 64  |odule are viewed|
00000630  20 61 73 20 73 65 70 61  72 61 74 65 20 62 79 20  | as separate by |
00000640  74 68 65 20 70 72 6f 67  72 61 6d 2c 20 73 6f 20  |the program, so |
00000650  66 6f 72 0a 65 78 61 6d  70 6c 65 20 73 65 6c 65  |for.example sele|
00000660  63 74 69 6e 67 20 61 6e  20 75 6e 70 6c 75 67 67  |cting an unplugg|
00000670  65 64 20 69 63 6f 6e 20  77 69 6c 6c 20 6f 6e 6c  |ed icon will onl|
00000680  79 20 64 65 73 65 6c 65  63 74 20 6f 74 68 65 72  |y deselect other|
00000690  20 75 6e 70 6c 75 67 67  65 64 0a 69 63 6f 6e 73  | unplugged.icons|
000006a0  2c 20 6e 6f 74 20 61 63  74 69 76 65 2c 20 72 75  |, not active, ru|
000006b0  6e 6e 69 6e 67 20 6f 72  20 64 6f 72 6d 61 6e 74  |nning or dormant|
000006c0  20 6f 6e 65 73 2e 0a 49  66 20 61 6e 79 20 63 68  | ones..If any ch|
000006d0  61 6e 67 65 73 20 68 61  76 65 20 74 61 6b 65 6e  |anges have taken|
000006e0  20 70 6c 61 63 65 20 69  6e 20 74 68 65 20 52 4d  | place in the RM|
000006f0  41 20 73 69 6e 63 65 20  74 68 65 20 70 72 6f 67  |A since the prog|
00000700  72 61 6d 20 6c 61 73 74  20 72 65 61 64 20 74 68  |ram last read th|
00000710  65 0a 63 6f 6e 74 65 6e  74 73 2c 20 74 68 65 6e  |e.contents, then|
00000720  20 61 20 2a 20 69 73 20  61 70 70 65 6e 64 65 64  | a * is appended|
00000730  20 74 6f 20 74 68 65 20  74 69 74 6c 65 20 62 61  | to the title ba|
00000740  72 2e 20 43 6c 69 63 6b  69 6e 67 20 74 68 65 20  |r. Clicking the |
00000750  6d 69 64 64 6c 65 20 62  75 74 74 6f 6e 0a 6f 76  |middle button.ov|
00000760  65 72 20 74 68 65 20 77  69 6e 64 6f 77 20 70 72  |er the window pr|
00000770  6f 64 75 63 65 73 20 74  68 65 20 66 6f 6c 6c 6f  |oduces the follo|
00000780  77 69 6e 67 20 6d 65 6e  75 20 6f 70 74 69 6f 6e  |wing menu option|
00000790  73 3a 0a 0a 0a 44 69 73  70 6c 61 79 20 3d 3e 20  |s:...Display => |
000007a0  20 4c 61 72 67 65 20 69  63 6f 6e 73 0a 20 20 20  | Large icons.   |
000007b0  20 20 20 20 20 20 20 20  20 53 6d 61 6c 6c 20 69  |         Small i|
000007c0  63 6f 6e 73 0a 20 20 20  20 20 20 20 20 20 20 20  |cons.           |
000007d0  20 46 75 6c 6c 20 69 6e  66 6f 0a 0a 54 68 69 73  | Full info..This|
000007e0  20 77 6f 72 6b 73 20 69  6e 20 74 68 65 20 73 61  | works in the sa|
000007f0  6d 65 20 77 61 79 20 74  68 61 74 20 61 20 66 69  |me way that a fi|
00000800  6c 65 72 20 77 69 6e 64  6f 77 20 77 6f 72 6b 73  |ler window works|
00000810  2e 20 20 54 68 65 20 27  46 75 6c 6c 20 69 6e 66  |.  The 'Full inf|
00000820  6f 27 0a 64 69 73 70 6c  61 79 20 70 72 6f 76 69  |o'.display provi|
00000830  64 65 73 20 74 68 65 20  69 6e 66 6f 72 6d 61 74  |des the informat|
00000840  69 6f 6e 20 3a 0a 73 68  6f 72 74 20 74 69 74 6c  |ion :.short titl|
00000850  65 20 20 20 20 6c 6f 6e  67 20 74 69 74 6c 65 20  |e    long title |
00000860  20 20 20 76 65 72 73 69  6f 6e 20 61 6e 64 20 64  |   version and d|
00000870  61 74 65 20 20 20 20 73  69 7a 65 0a 0a 0a 53 65  |ate    size...Se|
00000880  6c 65 63 74 69 6f 6e 20  3d 3e 20 20 20 52 4d 46  |lection =>   RMF|
00000890  61 73 74 65 72 0a 20 20  20 20 20 20 20 20 20 20  |aster.          |
000008a0  20 20 20 20 20 52 4d 52  65 49 6e 69 74 0a 20 20  |     RMReInit.  |
000008b0  20 20 20 20 20 20 20 20  20 20 20 20 20 55 6e 70  |             Unp|
000008c0  6c 75 67 0a 20 20 20 20  20 20 20 20 20 20 20 20  |lug.            |
000008d0  20 20 20 2d 2d 2d 2d 2d  2d 2d 2d 0a 20 20 20 20  |   --------.    |
000008e0  20 20 20 20 20 20 20 20  20 20 20 52 4d 4b 69 6c  |           RMKil|
000008f0  6c 0a 0a 54 68 65 73 65  20 63 6f 6d 6d 61 6e 64  |l..These command|
00000900  73 20 61 72 65 20 66 75  6c 6c 79 20 64 6f 63 75  |s are fully docu|
00000910  6d 65 6e 74 65 64 20 69  6e 20 74 68 65 20 52 69  |mented in the Ri|
00000920  73 63 20 4f 53 20 55 73  65 72 20 47 75 69 64 65  |sc OS User Guide|
00000930  2e 20 20 49 66 20 6f 6e  6c 79 20 6f 6e 65 0a 6d  |.  If only one.m|
00000940  6f 64 75 6c 65 20 69 73  20 73 65 6c 65 63 74 65  |odule is selecte|
00000950  64 20 74 68 65 20 69 74  73 20 74 69 74 6c 65 20  |d the its title |
00000960  77 69 6c 6c 20 62 65 20  64 69 73 70 6c 61 79 65  |will be displaye|
00000970  64 20 69 6e 20 74 68 65  20 6d 65 6e 75 2e 20 20  |d in the menu.  |
00000980  54 68 65 0a 63 6f 6d 6d  61 6e 64 73 20 61 76 61  |The.commands ava|
00000990  69 6c 61 62 6c 65 20 69  6e 20 74 68 65 20 73 75  |ilable in the su|
000009a0  62 6d 65 6e 75 20 6d 61  79 20 62 65 20 67 72 65  |bmenu may be gre|
000009b0  79 65 64 20 6f 75 74 20  69 66 20 74 68 65 79 20  |yed out if they |
000009c0  63 61 6e 6e 6f 74 20 62  65 0a 61 70 70 6c 69 65  |cannot be.applie|
000009d0  64 20 74 6f 20 74 68 65  20 70 61 72 74 69 63 75  |d to the particu|
000009e0  6c 61 72 20 6d 6f 64 75  6c 65 20 73 65 6c 65 63  |lar module selec|
000009f0  74 65 64 2c 20 65 67 20  79 6f 75 20 63 61 6e 6e  |ted, eg you cann|
00000a00  6f 74 20 75 6e 70 6c 75  67 20 61 20 52 41 4d 0a  |ot unplug a RAM.|
00000a10  6d 6f 64 75 6c 65 2e 20  49 66 20 61 20 6e 75 6d  |module. If a num|
00000a20  62 65 72 20 6f 66 20 6d  6f 64 75 6c 65 73 20 61  |ber of modules a|
00000a30  72 65 20 73 65 6c 65 63  74 65 64 2c 20 74 68 65  |re selected, the|
00000a40  6e 20 61 6c 6c 20 63 6f  6d 6d 61 6e 64 73 20 77  |n all commands w|
00000a50  69 6c 6c 20 62 65 0a 61  76 61 69 6c 61 62 6c 65  |ill be.available|
00000a60  20 66 72 6f 6d 20 74 68  65 20 6d 65 6e 75 2c 20  | from the menu, |
00000a70  62 75 74 20 77 69 6c 6c  20 6f 6e 6c 79 20 62 65  |but will only be|
00000a80  20 70 65 72 66 6f 72 6d  65 64 20 6f 6e 20 74 68  | performed on th|
00000a90  6f 73 65 20 6d 6f 64 75  6c 65 73 20 74 6f 0a 77  |ose modules to.w|
00000aa0  68 69 63 68 20 74 68 65  20 63 6f 6d 6d 61 6e 64  |hich the command|
00000ab0  20 69 73 20 6d 65 61 6e  69 6e 67 66 75 6c 2e 20  | is meaningful. |
00000ac0  20 54 68 65 20 63 6f 6d  6d 61 6e 64 73 20 6d 61  | The commands ma|
00000ad0  79 20 62 65 20 61 70 70  6c 69 65 64 20 61 73 20  |y be applied as |
00000ae0  66 6f 6c 6c 6f 77 73 20  3a 0a 0a 52 4f 4d 20 6d  |follows :..ROM m|
00000af0  6f 64 75 6c 65 73 0a 20  20 20 20 20 20 20 20 20  |odules.         |
00000b00  20 20 20 55 6e 70 6c 75  67 20 20 20 44 6f 72 6d  |   Unplug   Dorm|
00000b10  61 6e 74 20 20 41 63 74  69 76 65 20 20 20 52 75  |ant  Active   Ru|
00000b20  6e 6e 69 6e 67 0a 52 4d  46 61 73 74 65 72 20 20  |nning.RMFaster  |
00000b30  20 20 6e 6f 20 20 20 20  20 20 20 6e 6f 20 20 20  |  no       no   |
00000b40  20 20 20 20 79 65 73 20  20 20 20 20 20 79 65 73  |    yes      yes|
00000b50  0a 52 4d 52 65 49 6e 69  74 20 20 20 20 79 65 73  |.RMReInit    yes|
00000b60  20 20 20 20 20 20 79 65  73 20 20 20 20 20 20 79  |      yes      y|
00000b70  65 73 20 20 20 20 20 20  79 65 73 0a 55 6e 70 6c  |es      yes.Unpl|
00000b80  75 67 20 20 20 20 20 20  6e 6f 20 20 20 20 20 20  |ug      no      |
00000b90  20 79 65 73 20 20 20 20  20 20 79 65 73 20 20 20  | yes      yes   |
00000ba0  20 20 20 79 65 73 0a 52  4d 4b 69 6c 6c 20 20 20  |   yes.RMKill   |
00000bb0  20 20 20 6e 6f 20 20 20  20 20 20 20 6e 6f 20 20  |   no       no  |
00000bc0  20 20 20 20 20 79 65 73  20 20 20 20 20 20 6e 6f  |     yes      no|
00000bd0  0a 0a 52 41 4d 20 6d 6f  64 75 6c 65 73 0a 20 20  |..RAM modules.  |
00000be0  20 20 20 20 20 20 20 20  20 20 41 63 74 69 76 65  |          Active|
00000bf0  20 20 20 52 75 6e 6e 69  6e 67 0a 52 4d 46 61 73  |   Running.RMFas|
00000c00  74 65 72 20 20 20 20 6e  6f 20 20 20 20 20 20 20  |ter    no       |
00000c10  6e 6f 0a 52 4d 52 65 49  6e 69 74 20 20 20 20 79  |no.RMReInit    y|
00000c20  65 73 20 20 20 20 20 20  79 65 73 0a 55 6e 70 6c  |es      yes.Unpl|
00000c30  75 67 20 20 20 20 20 20  6e 6f 20 20 20 20 20 20  |ug      no      |
00000c40  20 6e 6f 0a 52 4d 4b 69  6c 6c 20 20 20 20 20 20  | no.RMKill      |
00000c50  79 65 73 20 20 20 20 20  20 6e 6f 0a 0a 4e 42 20  |yes      no..NB |
00000c60  73 6f 6d 65 20 61 63 74  69 6f 6e 73 20 77 69 6c  |some actions wil|
00000c70  6c 20 68 61 76 65 20 6e  6f 20 65 66 66 65 63 74  |l have no effect|
00000c80  20 6f 6e 20 73 6f 6d 65  20 6d 6f 64 75 6c 65 73  | on some modules|
00000c90  20 65 67 20 52 4d 52 65  49 6e 69 74 20 77 69 6c  | eg RMReInit wil|
00000ca0  6c 20 68 61 76 65 20 6e  6f 0a 65 66 66 65 63 74  |l have no.effect|
00000cb0  20 6f 6e 20 61 20 64 6f  72 6d 61 6e 74 20 45 63  | on a dormant Ec|
00000cc0  6f 6e 65 74 20 6d 6f 64  75 6c 65 20 75 6e 6c 65  |onet module unle|
00000cd0  73 73 20 74 68 65 72 65  20 69 73 20 45 63 6f 6e  |ss there is Econ|
00000ce0  65 74 20 68 61 72 64 77  61 72 65 20 70 72 65 73  |et hardware pres|
00000cf0  65 6e 74 20 69 6e 0a 74  68 65 20 6d 61 63 68 69  |ent in.the machi|
00000d00  6e 65 2e 0a 0a 57 41 52  4e 49 4e 47 20 2d 20 75  |ne...WARNING - u|
00000d10  73 65 20 6f 66 20 52 4d  4b 69 6c 6c 20 61 6e 64  |se of RMKill and|
00000d20  20 55 6e 70 6c 75 67 20  63 61 6e 20 63 61 75 73  | Unplug can caus|
00000d30  65 20 74 68 65 20 44 65  73 6b 74 6f 70 20 74 6f  |e the Desktop to|
00000d40  20 62 65 63 6f 6d 65 20  75 6e 75 73 61 62 6c 65  | become unusable|
00000d50  2c 0a 70 72 6f 64 75 63  65 20 66 72 65 71 75 65  |,.produce freque|
00000d60  6e 74 20 65 72 72 6f 72  73 20 6f 72 20 65 76 65  |nt errors or eve|
00000d70  6e 20 66 72 65 65 7a 65  20 75 70 20 69 66 20 74  |n freeze up if t|
00000d80  68 65 20 77 72 6f 6e 67  20 6d 6f 64 75 6c 65 73  |he wrong modules|
00000d90  20 61 72 65 20 61 66 66  65 63 74 65 64 0a 28 79  | are affected.(y|
00000da0  6f 75 20 77 69 6c 6c 20  70 72 6f 62 61 62 6c 79  |ou will probably|
00000db0  20 72 65 71 75 69 72 65  20 52 2d 50 6f 77 65 72  | require R-Power|
00000dc0  4f 6e 20 74 6f 20 72 65  6d 65 64 79 20 74 68 69  |On to remedy thi|
00000dd0  73 20 2d 20 73 65 65 20  72 65 6c 65 76 61 6e 74  |s - see relevant|
00000de0  20 73 65 63 74 69 6f 6e  0a 69 6e 20 52 69 73 63  | section.in Risc|
00000df0  20 4f 53 20 67 75 69 64  65 29 2e 20 20 49 74 20  | OS guide).  It |
00000e00  69 73 20 6e 6f 74 20 61  20 67 6f 6f 64 20 69 64  |is not a good id|
00000e10  65 61 20 74 6f 20 75 73  65 20 74 68 65 73 65 20  |ea to use these |
00000e20  63 6f 6d 6d 61 6e 64 73  20 6f 6e 20 74 68 65 20  |commands on the |
00000e30  52 4f 4d 0a 6d 6f 64 75  6c 65 73 20 75 6e 6c 65  |ROM.modules unle|
00000e40  73 73 20 79 6f 75 20 6b  6e 6f 77 20 77 68 61 74  |ss you know what|
00000e50  20 79 6f 75 20 61 72 65  20 64 6f 69 6e 67 2e 0a  | you are doing..|
00000e60  0a 0a 53 65 6c 65 63 74  20 61 6c 6c 20 3d 3e 20  |..Select all => |
00000e70  20 20 20 20 20 20 20 55  6e 70 6c 75 67 67 65 64  |       Unplugged|
00000e80  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00000e90  20 20 20 20 20 20 44 6f  72 6d 61 6e 74 0a 20 20  |      Dormant.  |
00000ea0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000eb0  20 20 20 41 63 74 69 76  65 0a 20 20 20 20 20 20  |   Active.      |
00000ec0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 52  |               R|
00000ed0  75 6e 6e 69 6e 67 0a 0a  43 6c 65 61 72 20 73 65  |unning..Clear se|
00000ee0  6c 65 63 74 69 6f 6e 20  3d 3e 20 20 20 55 6e 70  |lection =>   Unp|
00000ef0  6c 75 67 67 65 64 0a 20  20 20 20 20 20 20 20 20  |lugged.         |
00000f00  20 20 20 20 20 20 20 20  20 20 20 20 44 6f 72 6d  |            Dorm|
00000f10  61 6e 74 0a 20 20 20 20  20 20 20 20 20 20 20 20  |ant.            |
00000f20  20 20 20 20 20 20 20 20  20 41 63 74 69 76 65 0a  |         Active.|
00000f30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000f40  20 20 20 20 20 52 75 6e  6e 69 6e 67 0a 0a 57 68  |     Running..Wh|
00000f50  65 6e 20 74 68 65 20 6d  61 69 6e 20 6d 65 6e 75  |en the main menu|
00000f60  20 69 74 65 6d 20 69 73  20 63 6c 69 63 6b 65 64  | item is clicked|
00000f70  20 6f 6e 2c 20 74 68 65  73 65 20 61 63 74 20 69  | on, these act i|
00000f80  6e 20 74 68 65 20 73 61  6d 65 20 77 61 79 20 61  |n the same way a|
00000f90  73 20 61 20 6e 6f 72 6d  61 6c 0a 66 69 6c 65 72  |s a normal.filer|
00000fa0  2e 20 20 54 68 65 20 73  75 62 2d 6d 65 6e 75 73  |.  The sub-menus|
00000fb0  20 61 6c 6c 6f 77 20 61  20 70 61 72 74 69 63 75  | allow a particu|
00000fc0  6c 61 72 20 67 72 6f 75  70 20 6f 66 20 6d 6f 64  |lar group of mod|
00000fd0  75 6c 65 73 20 74 6f 20  62 65 20 73 65 6c 65 63  |ules to be selec|
00000fe0  74 65 64 20 6f 72 0a 64  65 73 65 6c 65 63 74 65  |ted or.deselecte|
00000ff0  64 2e 0a 0a 0a 4f 70 74  69 6f 6e 73 20 2d 20 73  |d....Options - s|
00001000  65 65 20 6c 61 74 65 72  20 73 65 63 74 69 6f 6e  |ee later section|
00001010  0a 0a 0a 4d 6f 64 75 6c  65 20 61 72 65 61 20 3d  |...Module area =|
00001020  3e 20 52 4d 43 6c 65 61  72 0a 20 20 20 20 20 20  |> RMClear.      |
00001030  20 20 20 20 20 20 20 20  20 4d 69 6e 69 6d 69 73  |         Minimis|
00001040  65 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |e.              |
00001050  20 52 4d 54 69 64 79 0a  0a 54 68 65 73 65 20 6f  | RMTidy..These o|
00001060  70 74 69 6f 6e 73 20 61  70 70 6c 79 20 74 6f 20  |ptions apply to |
00001070  74 68 65 20 77 68 6f 6c  65 20 6d 6f 64 75 6c 65  |the whole module|
00001080  20 61 72 65 61 2e 20 20  52 4d 43 6c 65 61 72 20  | area.  RMClear |
00001090  61 6e 64 20 52 4d 54 69  64 79 20 61 72 65 0a 64  |and RMTidy are.d|
000010a0  6f 63 75 6d 65 6e 74 65  64 20 69 6e 20 74 68 65  |ocumented in the|
000010b0  20 52 69 73 63 20 4f 53  20 67 75 69 64 65 2e 20  | Risc OS guide. |
000010c0  20 4d 69 6e 69 6d 69 73  65 20 72 65 64 75 63 65  | Minimise reduce|
000010d0  73 20 74 68 65 20 66 72  65 65 20 73 70 61 63 65  |s the free space|
000010e0  20 69 6e 20 74 68 65 20  52 4d 41 0a 74 6f 20 61  | in the RMA.to a|
000010f0  20 6d 69 6e 69 6d 75 6d  20 2d 20 74 68 65 20 73  | minimum - the s|
00001100  61 6d 65 20 65 66 66 65  63 74 20 61 73 20 69 73  |ame effect as is|
00001110  20 61 63 68 69 65 76 65  64 20 62 79 20 64 72 61  | achieved by dra|
00001120  67 67 69 6e 67 20 74 68  65 20 52 4d 41 20 73 69  |gging the RMA si|
00001130  7a 65 20 62 61 72 0a 74  6f 20 74 68 65 20 6c 65  |ze bar.to the le|
00001140  66 74 20 69 6e 20 74 68  65 20 74 61 73 6b 20 64  |ft in the task d|
00001150  69 73 70 6c 61 79 20 77  69 6e 64 6f 77 2e 20 20  |isplay window.  |
00001160  53 69 6e 63 65 20 52 4d  54 69 64 79 20 68 61 73  |Since RMTidy has|
00001170  20 61 20 6e 61 73 74 79  20 68 61 62 69 74 20 6f  | a nasty habit o|
00001180  66 0a 65 61 74 69 6e 67  20 74 68 65 20 64 65 73  |f.eating the des|
00001190  6b 74 6f 70 20 65 6e 76  69 72 6f 6e 6d 65 6e 74  |ktop environment|
000011a0  2c 20 69 74 20 69 73 20  6e 6f 74 20 61 63 74 75  |, it is not actu|
000011b0  61 6c 6c 79 20 70 6f 73  73 69 62 6c 65 20 74 6f  |ally possible to|
000011c0  20 73 65 6c 65 63 74 20  74 68 69 73 0a 69 74 65  | select this.ite|
000011d0  6d 20 61 74 20 74 68 65  20 6d 6f 6d 65 6e 74 2e  |m at the moment.|
000011e0  0a 0a 0a 55 70 64 61 74  65 0a 0a 54 68 69 73 20  |...Update..This |
000011f0  72 65 72 65 61 64 73 20  74 68 65 20 6d 6f 64 75  |rereads the modu|
00001200  6c 65 73 20 63 6f 6e 74  61 69 6e 65 64 20 69 6e  |les contained in|
00001210  20 74 68 65 20 52 4d 41  20 61 6e 64 20 72 65 64  | the RMA and red|
00001220  72 61 77 73 20 74 68 65  20 77 69 6e 64 6f 77 2e  |raws the window.|
00001230  20 20 49 66 0a 74 68 65  20 74 69 74 6c 65 20 62  |  If.the title b|
00001240  61 72 20 73 68 6f 77 65  64 20 61 20 2a 2c 20 74  |ar showed a *, t|
00001250  68 65 6e 20 74 68 69 73  20 69 73 20 72 65 6d 6f  |hen this is remo|
00001260  76 65 64 2e 0a 0a 0a 32  29 20 4d 6f 64 75 6c 65  |ved....2) Module|
00001270  20 69 6e 66 6f 72 6d 61  74 69 6f 6e 20 77 69 6e  | information win|
00001280  64 6f 77 0a 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |dow.------------|
00001290  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
000012a0  0a 0a 54 68 65 20 6d 6f  64 75 6c 65 20 69 6e 66  |..The module inf|
000012b0  6f 72 6d 61 74 69 6f 6e  20 77 69 6e 64 6f 77 20  |ormation window |
000012c0  67 69 76 65 73 20 61 20  64 65 74 61 69 6c 65 64  |gives a detailed|
000012d0  20 62 72 65 61 6b 64 6f  77 6e 20 6f 66 20 74 68  | breakdown of th|
000012e0  65 20 66 61 63 69 6c 69  74 69 65 73 0a 70 72 6f  |e facilities.pro|
000012f0  76 69 64 65 64 20 62 79  20 61 20 70 61 72 74 69  |vided by a parti|
00001300  63 75 6c 61 72 20 6d 6f  64 75 6c 65 2e 20 20 54  |cular module.  T|
00001310  6f 20 6f 70 65 6e 20 74  68 65 20 77 69 6e 64 6f  |o open the windo|
00001320  77 20 66 6f 72 20 61 20  6d 6f 64 75 6c 65 2c 20  |w for a module, |
00001330  64 6f 75 62 6c 65 0a 63  6c 69 63 6b 20 6f 6e 20  |double.click on |
00001340  74 68 65 20 6d 6f 64 75  6c 65 20 69 6e 20 74 68  |the module in th|
00001350  65 20 66 69 6c 65 72 20  64 69 73 70 6c 61 79 20  |e filer display |
00001360  77 69 6e 64 6f 77 2e 20  20 44 6f 75 62 6c 65 20  |window.  Double |
00001370  63 6c 69 63 6b 69 6e 67  20 77 69 74 68 0a 61 64  |clicking with.ad|
00001380  6a 75 73 74 20 63 61 75  73 65 73 20 74 68 65 20  |just causes the |
00001390  66 69 6c 65 72 20 77 69  6e 64 6f 77 20 74 6f 20  |filer window to |
000013a0  62 65 20 63 6c 6f 73 65  64 20 62 65 66 6f 72 65  |be closed before|
000013b0  20 74 68 65 20 69 6e 66  6f 72 6d 61 74 69 6f 6e  | the information|
000013c0  20 77 69 6e 64 6f 77 20  69 73 0a 6f 70 65 6e 65  | window is.opene|
000013d0  64 2e 20 20 43 6f 6e 76  65 72 73 65 6c 79 2c 20  |d.  Conversely, |
000013e0  63 6c 69 63 6b 69 6e 67  20 6f 6e 20 74 68 65 20  |clicking on the |
000013f0  69 6e 66 6f 72 6d 61 74  69 6f 6e 20 77 69 6e 64  |information wind|
00001400  6f 77 27 73 20 63 6c 6f  73 65 20 69 63 6f 6e 20  |ow's close icon |
00001410  77 69 74 68 0a 61 64 6a  75 73 74 20 63 61 75 73  |with.adjust caus|
00001420  65 73 20 74 68 65 20 66  69 6c 65 72 20 77 69 6e  |es the filer win|
00001430  64 6f 77 20 74 6f 20 62  65 20 72 65 6f 70 65 6e  |dow to be reopen|
00001440  65 64 2e 20 20 49 66 2c  20 61 74 20 61 6e 79 20  |ed.  If, at any |
00001450  74 69 6d 65 2c 20 74 68  65 20 6d 6f 64 75 6c 65  |time, the module|
00001460  0a 61 62 6f 75 74 20 77  68 69 63 68 20 74 68 65  |.about which the|
00001470  20 77 69 6e 64 6f 77 20  63 6f 6e 74 61 69 6e 73  | window contains|
00001480  20 69 6e 66 6f 72 6d 61  74 69 6f 6e 20 69 73 20  | information is |
00001490  6d 6f 76 65 64 20 6f 72  20 65 72 61 73 65 64 20  |moved or erased |
000014a0  66 72 6f 6d 20 74 68 65  20 52 4d 41 2c 0a 74 68  |from the RMA,.th|
000014b0  65 6e 20 74 68 65 20 69  6e 66 6f 72 6d 61 74 69  |en the informati|
000014c0  6f 6e 20 77 69 6e 64 6f  77 20 63 6c 6f 73 65 73  |on window closes|
000014d0  2e 20 20 4f 6e 6c 79 20  6f 6e 65 20 69 6e 66 6f  |.  Only one info|
000014e0  72 6d 61 74 69 6f 6e 20  77 69 6e 64 6f 77 20 6d  |rmation window m|
000014f0  61 79 20 62 65 20 6f 70  65 6e 0a 61 74 20 61 6e  |ay be open.at an|
00001500  79 20 74 69 6d 65 2e 0a  54 68 65 20 77 69 6e 64  |y time..The wind|
00001510  6f 77 20 73 68 6f 75 6c  64 20 62 65 20 66 61 69  |ow should be fai|
00001520  72 6c 79 20 73 65 6c 66  20 65 78 70 6c 61 6e 61  |rly self explana|
00001530  74 6f 72 79 20 74 6f 20  61 6e 79 6f 6e 65 20 77  |tory to anyone w|
00001540  68 6f 20 75 6e 64 65 72  73 74 61 6e 64 73 20 74  |ho understands t|
00001550  68 65 0a 69 6e 74 65 72  6e 61 6c 73 20 6f 66 20  |he.internals of |
00001560  61 20 6d 6f 64 75 6c 65  2e 20 20 56 65 72 79 20  |a module.  Very |
00001570  62 61 73 69 63 61 6c 6c  79 20 74 68 65 20 77 69  |basically the wi|
00001580  6e 64 6f 77 20 67 69 76  65 73 20 61 20 6c 69 73  |ndow gives a lis|
00001590  74 20 6f 66 20 69 6d 70  6f 72 74 61 6e 74 0a 6c  |t of important.l|
000015a0  6f 63 61 74 69 6f 6e 73  20 77 69 74 68 69 6e 20  |ocations within |
000015b0  61 20 6d 6f 64 75 6c 65  20 61 6e 64 20 61 6c 73  |a module and als|
000015c0  6f 20 61 20 6c 69 73 74  20 6f 66 20 74 68 65 20  |o a list of the |
000015d0  2a 63 6f 6d 6d 61 6e 64  73 20 61 6e 64 20 53 57  |*commands and SW|
000015e0  49 2f 53 59 53 20 63 61  6c 6c 73 0a 74 68 61 74  |I/SYS calls.that|
000015f0  20 69 74 20 73 75 70 70  6f 72 74 73 2e 20 20 41  | it supports.  A|
00001600  6c 6c 20 6e 75 6d 62 65  72 73 20 61 72 65 20 68  |ll numbers are h|
00001610  65 78 20 65 78 63 65 70  74 20 66 6f 72 20 74 68  |ex except for th|
00001620  65 20 73 69 7a 65 2e 0a  0a 0a 32 61 29 20 43 6f  |e size....2a) Co|
00001630  6d 6d 61 6e 64 20 69 6e  66 6f 72 6d 61 74 69 6f  |mmand informatio|
00001640  6e 20 77 69 6e 64 6f 77  0a 2d 2d 2d 2d 2d 2d 2d  |n window.-------|
00001650  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00001660  2d 2d 2d 2d 2d 2d 2d 0a  0a 54 68 69 73 20 77 69  |-------..This wi|
00001670  6e 64 6f 77 20 77 6f 72  6b 73 20 69 6e 20 74 68  |ndow works in th|
00001680  65 20 73 61 6d 65 20 77  61 79 20 74 68 61 74 20  |e same way that |
00001690  74 68 65 20 6d 6f 64 75  6c 65 20 69 6e 66 6f 72  |the module infor|
000016a0  6d 61 74 69 6f 6e 20 77  69 6e 64 6f 77 20 64 6f  |mation window do|
000016b0  65 73 2c 0a 65 78 63 65  70 74 20 74 68 61 74 20  |es,.except that |
000016c0  69 74 20 67 69 76 65 73  20 69 6e 66 6f 72 6d 61  |it gives informa|
000016d0  74 69 6f 6e 20 61 62 6f  75 74 20 61 20 70 61 72  |tion about a par|
000016e0  74 69 63 75 6c 61 72 20  2a 63 6f 6d 6d 61 6e 64  |ticular *command|
000016f0  2e 20 20 54 68 65 20 77  69 6e 64 6f 77 20 69 73  |.  The window is|
00001700  0a 6f 70 65 6e 65 64 20  62 79 20 63 6c 69 63 6b  |.opened by click|
00001710  69 6e 67 20 6f 6e 20 6f  6e 65 20 6f 66 20 74 68  |ing on one of th|
00001720  65 20 2a 63 6f 6d 6d 61  6e 64 73 20 69 6e 20 74  |e *commands in t|
00001730  68 65 20 6d 6f 64 75 6c  65 20 69 6e 66 6f 72 6d  |he module inform|
00001740  61 74 69 6f 6e 20 77 69  6e 64 6f 77 2e 20 0a 41  |ation window. .A|
00001750  67 61 69 6e 2c 20 75 73  69 6e 67 20 61 64 6a 75  |gain, using adju|
00001760  73 74 20 77 69 6c 6c 20  63 6c 6f 73 65 2f 6f 70  |st will close/op|
00001770  65 6e 20 74 68 65 20 70  61 72 65 6e 74 20 77 69  |en the parent wi|
00001780  6e 64 6f 77 2e 0a 54 68  65 20 61 64 64 72 65 73  |ndow..The addres|
00001790  73 65 73 20 61 72 65 20  69 6e 20 68 65 78 2c 20  |ses are in hex, |
000017a0  74 68 65 20 70 61 72 61  6d 65 74 65 72 20 70 61  |the parameter pa|
000017b0  72 61 6d 65 74 65 72 73  20 28 3f 29 20 61 72 65  |rameters (?) are|
000017c0  20 64 65 63 69 6d 61 6c  20 61 6e 64 20 74 68 65  | decimal and the|
000017d0  0a 47 53 54 72 61 6e 73  20 61 6e 64 20 66 6c 61  |.GSTrans and fla|
000017e0  67 73 20 61 72 65 20 62  69 6e 61 72 79 2e 20 20  |gs are binary.  |
000017f0  54 68 65 20 77 69 6e 64  6f 77 20 61 6c 73 6f 20  |The window also |
00001800  61 74 74 65 6d 70 74 73  20 74 6f 20 64 69 73 70  |attempts to disp|
00001810  6c 61 79 20 74 68 65 20  68 65 6c 70 0a 61 6e 64  |lay the help.and|
00001820  20 73 79 6e 74 61 78 20  73 74 72 69 6e 67 73 20  | syntax strings |
00001830  66 6f 72 20 74 68 65 20  63 6f 6d 6d 61 6e 64 2e  |for the command.|
00001840  20 20 49 66 20 74 68 65  20 68 65 6c 70 20 74 65  |  If the help te|
00001850  78 74 20 69 73 20 70 72  6f 64 75 63 65 64 20 62  |xt is produced b|
00001860  79 20 61 0a 73 65 63 74  69 6f 6e 20 6f 66 20 63  |y a.section of c|
00001870  6f 64 65 20 28 65 67 20  2a 48 65 6c 70 20 4d 6f  |ode (eg *Help Mo|
00001880  64 75 6c 65 73 29 2c 20  74 68 65 6e 20 74 68 65  |dules), then the|
00001890  20 68 65 6c 70 20 74 65  78 74 20 69 73 20 6e 6f  | help text is no|
000018a0  74 20 69 6e 63 6c 75 64  65 64 20 69 6e 0a 74 68  |t included in.th|
000018b0  65 20 77 69 6e 64 6f 77  20 61 73 20 69 74 20 63  |e window as it c|
000018c0  6f 75 6c 64 20 62 65 63  6f 6d 65 20 76 65 72 79  |ould become very|
000018d0  20 6c 61 72 67 65 20 69  6e 64 65 65 64 2e 0a 0a  | large indeed...|
000018e0  0a 33 29 20 53 61 76 69  6e 67 20 6d 6f 64 75 6c  |.3) Saving modul|
000018f0  65 73 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |es.-------------|
00001900  2d 2d 2d 2d 0a 0a 4d 6f  64 75 6c 65 73 2c 20 6f  |----..Modules, o|
00001910  72 20 67 72 6f 75 70 73  20 6f 66 20 6d 6f 64 75  |r groups of modu|
00001920  6c 65 73 2c 20 63 61 6e  20 62 65 20 73 61 76 65  |les, can be save|
00001930  64 20 74 6f 20 61 20 66  69 6c 65 72 20 6f 72 20  |d to a filer or |
00001940  65 64 69 74 6f 72 20 62  79 20 64 72 61 67 67 69  |editor by draggi|
00001950  6e 67 0a 74 68 65 6d 20  69 6e 20 61 20 73 69 6d  |ng.them in a sim|
00001960  69 6c 61 72 20 77 61 79  20 74 6f 20 61 20 6e 6f  |ilar way to a no|
00001970  72 6d 61 6c 20 66 69 6c  65 72 20 77 69 6e 64 6f  |rmal filer windo|
00001980  77 2e 20 20 4e 6f 74 65  20 74 68 61 74 20 61 6c  |w.  Note that al|
00001990  6c 20 6d 75 6c 74 69 70  6c 65 0a 64 72 61 67 73  |l multiple.drags|
000019a0  20 6d 75 73 74 20 62 65  20 70 65 72 66 6f 72 6d  | must be perform|
000019b0  65 64 20 77 69 74 68 20  74 68 65 20 61 64 6a 75  |ed with the adju|
000019c0  73 74 20 62 75 74 74 6f  6e 2e 20 20 49 66 20 61  |st button.  If a|
000019d0  20 67 72 6f 75 70 20 6f  66 20 66 69 6c 65 73 20  | group of files |
000019e0  61 72 65 0a 64 72 61 67  67 65 64 20 6f 6e 74 6f  |are.dragged onto|
000019f0  20 61 6e 20 61 70 70 6c  69 63 61 74 69 6f 6e 20  | an application |
00001a00  72 61 74 68 65 72 20 74  68 61 6e 20 61 20 66 69  |rather than a fi|
00001a10  6c 65 72 20 77 69 6e 64  6f 77 2c 20 74 68 65 6e  |ler window, then|
00001a20  20 6f 6e 6c 79 20 74 68  65 20 66 69 72 73 74 0a  | only the first.|
00001a30  6f 6e 65 20 69 6e 20 74  68 65 20 67 72 6f 75 70  |one in the group|
00001a40  20 77 69 6c 6c 20 62 65  20 74 72 61 6e 73 66 65  | will be transfe|
00001a50  72 72 65 64 2e 20 20 42  65 63 61 75 73 65 20 69  |rred.  Because i|
00001a60  74 20 69 73 20 70 6f 73  73 69 62 6c 65 20 66 6f  |t is possible fo|
00001a70  72 20 61 20 6d 6f 64 75  6c 65 0a 74 69 74 6c 65  |r a module.title|
00001a80  20 74 6f 20 65 78 63 65  65 64 20 74 68 65 20 74  | to exceed the t|
00001a90  65 6e 20 63 68 61 72 61  63 74 65 72 20 66 69 6c  |en character fil|
00001aa0  65 6e 61 6d 65 20 6c 69  6d 69 74 2c 20 6c 6f 6e  |ename limit, lon|
00001ab0  67 20 66 69 6c 65 6e 61  6d 65 73 20 61 72 65 20  |g filenames are |
00001ac0  72 65 64 75 63 65 64 0a  62 79 20 72 65 6d 6f 76  |reduced.by remov|
00001ad0  69 6e 67 20 76 6f 77 65  6c 73 2e 20 20 54 68 69  |ing vowels.  Thi|
00001ae0  73 20 69 73 20 62 65 74  74 65 72 20 61 74 20 61  |s is better at a|
00001af0  76 6f 69 64 69 6e 67 20  66 69 6c 65 6e 61 6d 65  |voiding filename|
00001b00  20 63 6c 61 73 68 65 73  20 74 68 61 6e 20 61 0a  | clashes than a.|
00001b10  73 69 6d 70 6c 65 20 74  72 75 6e 63 61 74 69 6f  |simple truncatio|
00001b20  6e 20 61 6e 64 20 69 73  20 75 73 75 61 6c 6c 79  |n and is usually|
00001b30  20 70 65 72 66 65 63 74  6c 79 20 75 6e 64 65 72  | perfectly under|
00001b40  73 74 61 6e 64 61 62 6c  65 2e 20 20 4f 6e 63 65  |standable.  Once|
00001b50  20 73 61 76 65 64 2c 20  74 68 65 0a 66 69 6c 65  | saved, the.file|
00001b60  6e 61 6d 65 73 20 63 61  6e 20 62 65 20 61 6c 74  |names can be alt|
00001b70  65 72 65 64 20 61 74 20  77 69 6c 6c 2e 0a 0a 0a  |ered at will....|
00001b80  34 29 20 4f 70 74 69 6f  6e 73 20 77 69 6e 64 6f  |4) Options windo|
00001b90  77 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |w.--------------|
00001ba0  2d 2d 2d 0a 0a 54 68 65  20 6f 70 74 69 6f 6e 73  |---..The options|
00001bb0  20 77 69 6e 64 6f 77 20  69 73 20 6f 70 65 6e 65  | window is opene|
00001bc0  64 20 62 79 20 73 65 6c  65 63 74 69 6e 67 20 27  |d by selecting '|
00001bd0  4f 70 74 69 6f 6e 73 27  20 66 72 6f 6d 20 65 69  |Options' from ei|
00001be0  74 68 65 72 20 74 68 65  20 6d 61 69 6e 0a 77 69  |ther the main.wi|
00001bf0  6e 64 6f 77 27 73 20 6d  65 6e 75 20 6f 72 20 74  |ndow's menu or t|
00001c00  68 65 20 69 63 6f 6e 62  61 72 20 6d 65 6e 75 2e  |he iconbar menu.|
00001c10  0a 54 68 65 20 66 69 72  73 74 20 73 65 63 74 69  |.The first secti|
00001c20  6f 6e 20 64 65 61 6c 73  20 77 69 74 68 20 74 68  |on deals with th|
00001c30  65 20 63 6f 6c 6f 75 72  20 6f 66 20 68 69 67 68  |e colour of high|
00001c40  6c 69 67 68 74 20 75 73  65 64 20 66 6f 72 20 65  |light used for e|
00001c50  61 63 68 20 6f 66 20 74  68 65 0a 66 6f 75 72 20  |ach of the.four |
00001c60  67 72 6f 75 70 73 20 6f  66 20 6d 6f 64 75 6c 65  |groups of module|
00001c70  73 2e 20 20 49 74 20 69  73 20 6e 6f 74 20 6e 65  |s.  It is not ne|
00001c80  63 65 73 73 61 72 79 20  74 6f 20 68 61 76 65 20  |cessary to have |
00001c90  64 69 66 66 65 72 65 6e  74 20 67 72 6f 75 70 73  |different groups|
00001ca0  0a 68 69 67 68 6c 69 67  68 74 65 64 2c 20 73 69  |.highlighted, si|
00001cb0  6e 63 65 20 74 68 65 79  20 61 72 65 20 69 6e 64  |nce they are ind|
00001cc0  69 63 61 74 65 64 20 62  79 20 64 69 66 66 65 72  |icated by differ|
00001cd0  65 6e 74 20 69 63 6f 6e  73 2c 20 62 75 74 20 69  |ent icons, but i|
00001ce0  74 20 69 74 20 65 61 73  69 65 72 0a 74 6f 20 73  |t it easier.to s|
00001cf0  70 6f 74 20 74 68 65 20  63 6f 6c 6f 75 72 65 64  |pot the coloured|
00001d00  20 74 65 78 74 20 74 68  61 6e 20 74 68 65 20 69  | text than the i|
00001d10  63 6f 6e 20 28 69 6e 20  6d 79 20 6f 70 69 6e 69  |con (in my opini|
00001d20  6f 6e 20 61 6e 79 77 61  79 29 2e 20 20 54 6f 20  |on anyway).  To |
00001d30  63 68 61 6e 67 65 20 61  0a 63 6f 6c 6f 75 72 2c  |change a.colour,|
00001d40  20 70 72 65 73 73 20 74  68 65 20 6d 65 6e 75 20  | press the menu |
00001d50  62 75 74 74 6f 6e 20 6f  76 65 72 20 6f 6e 65 20  |button over one |
00001d60  6f 66 20 74 68 65 20 63  6f 6c 6f 75 72 65 64 20  |of the coloured |
00001d70  62 6f 78 65 73 20 61 6e  64 20 61 20 73 74 61 6e  |boxes and a stan|
00001d80  64 61 72 64 0a 63 6f 6c  6f 75 72 20 6d 65 6e 75  |dard.colour menu|
00001d90  20 77 69 6c 6c 20 61 70  70 65 61 72 2e 0a 54 68  | will appear..Th|
00001da0  65 20 6e 65 78 74 20 73  65 63 74 69 6f 6e 20 64  |e next section d|
00001db0  65 61 6c 73 20 77 69 74  68 20 77 68 65 6e 20 74  |eals with when t|
00001dc0  68 65 20 73 63 72 65 65  6e 20 64 69 73 70 6c 61  |he screen displa|
00001dd0  79 20 73 68 6f 75 6c 64  20 62 65 20 75 70 64 61  |y should be upda|
00001de0  74 65 64 2e 20 0a 57 68  61 74 65 76 65 72 20 68  |ted. .Whatever h|
00001df0  61 70 70 65 6e 73 2c 20  75 70 64 61 74 65 73 20  |appens, updates |
00001e00  77 69 6c 6c 20 6f 6e 6c  79 20 6f 63 63 75 72 20  |will only occur |
00001e10  77 68 65 6e 20 74 68 65  20 77 69 6e 64 6f 77 20  |when the window |
00001e20  69 73 20 6f 70 65 6e 2c  20 6e 65 76 65 72 0a 63  |is open, never.c|
00001e30  6c 6f 73 65 64 2e 20 20  49 66 20 74 68 65 20 77  |losed.  If the w|
00001e40  69 6e 64 6f 77 20 69 73  20 63 6c 6f 73 65 64 20  |indow is closed |
00001e50  61 6e 64 20 61 6e 20 75  70 64 61 74 65 20 69 73  |and an update is|
00001e60  20 72 65 71 75 69 72 65  64 2c 20 74 68 65 6e 20  | required, then |
00001e70  69 74 20 77 69 6c 6c 0a  74 61 6b 65 20 70 6c 61  |it will.take pla|
00001e80  63 65 20 77 68 65 6e 20  74 68 65 20 77 69 6e 64  |ce when the wind|
00001e90  6f 77 20 69 73 20 6e 65  78 74 20 6f 70 65 6e 65  |ow is next opene|
00001ea0  64 2e 20 20 54 68 65 20  70 72 6f 67 72 61 6d 20  |d.  The program |
00001eb0  6d 6f 6e 69 74 6f 72 73  20 61 6c 6c 0a 6f 70 65  |monitors all.ope|
00001ec0  72 61 74 69 6f 6e 73 20  70 65 72 66 6f 72 6d 65  |rations performe|
00001ed0  64 20 6f 6e 20 74 68 65  20 52 4d 41 2c 20 65 76  |d on the RMA, ev|
00001ee0  65 6e 20 74 68 6f 73 65  20 62 79 20 6f 74 68 65  |en those by othe|
00001ef0  72 20 70 72 6f 67 72 61  6d 73 2e 20 20 41 6e 20  |r programs.  An |
00001f00  75 70 64 61 74 65 0a 77  69 6c 6c 20 41 4c 57 41  |update.will ALWA|
00001f10  59 53 20 62 65 20 73 63  68 65 64 75 6c 65 64 20  |YS be scheduled |
00001f20  69 66 20 61 20 6d 6f 64  75 6c 65 20 69 73 20 52  |if a module is R|
00001f30  4d 4b 69 6c 6c 65 64 20  6f 72 20 55 6e 70 6c 75  |MKilled or Unplu|
00001f40  67 67 65 64 2e 20 20 41  6c 6c 20 6f 74 68 65 72  |gged.  All other|
00001f50  0a 52 4d 41 20 6f 70 65  72 61 74 69 6f 6e 73 20  |.RMA operations |
00001f60  61 72 65 20 63 6f 6e 74  72 6f 6c 6c 65 64 20 62  |are controlled b|
00001f70  79 20 74 68 65 20 6f 70  74 69 6f 6e 73 20 77 69  |y the options wi|
00001f80  6e 64 6f 77 2e 20 20 49  66 20 74 68 65 20 75 70  |ndow.  If the up|
00001f90  64 61 74 65 20 69 73 20  73 65 74 0a 74 6f 20 61  |date is set.to a|
00001fa0  75 74 6f 6d 61 74 69 63  2c 20 74 68 65 6e 20 74  |utomatic, then t|
00001fb0  68 65 20 64 69 73 70 6c  61 79 20 77 69 6c 6c 20  |he display will |
00001fc0  62 65 20 73 63 68 65 64  75 6c 65 64 20 66 6f 72  |be scheduled for|
00001fd0  20 75 70 64 61 74 65 20  65 76 65 72 79 20 74 69  | update every ti|
00001fe0  6d 65 20 61 6e 0a 52 4d  41 20 6f 70 65 72 61 74  |me an.RMA operat|
00001ff0  69 6f 6e 20 6f 63 63 75  72 73 2e 20 20 49 66 20  |ion occurs.  If |
00002000  74 68 65 20 73 65 74 74  69 6e 67 20 69 73 20 6d  |the setting is m|
00002010  61 6e 75 61 6c 20 74 68  65 6e 20 74 68 65 20 70  |anual then the p|
00002020  72 6f 67 72 61 6d 20 77  69 6c 6c 20 62 65 65 70  |rogram will beep|
00002030  0a 61 6e 64 20 61 20 2a  20 77 69 6c 6c 20 62 65  |.and a * will be|
00002040  20 61 70 70 65 6e 64 65  64 20 74 6f 20 74 68 65  | appended to the|
00002050  20 74 69 74 6c 65 20 62  61 72 20 6f 66 20 74 68  | title bar of th|
00002060  65 20 6d 61 69 6e 20 77  69 6e 64 6f 77 2e 20 20  |e main window.  |
00002070  54 68 65 20 75 73 65 72  20 69 73 0a 74 68 65 6e  |The user is.then|
00002080  20 72 65 73 70 6f 6e 73  69 62 6c 65 20 66 6f 72  | responsible for|
00002090  20 75 70 64 61 74 69 6e  67 20 74 68 65 20 64 69  | updating the di|
000020a0  73 70 6c 61 79 20 62 79  20 63 68 6f 6f 73 69 6e  |splay by choosin|
000020b0  67 20 74 68 65 20 27 55  70 64 61 74 65 27 20 6f  |g the 'Update' o|
000020c0  70 74 69 6f 6e 0a 66 72  6f 6d 20 74 68 65 20 6d  |ption.from the m|
000020d0  65 6e 75 2e 0a 54 68 65  20 66 69 6e 61 6c 20 73  |enu..The final s|
000020e0  65 63 74 69 6f 6e 20 63  6f 6e 74 72 6f 6c 73 20  |ection controls |
000020f0  74 68 65 20 64 69 73 70  6c 61 79 20 6f 66 20 61  |the display of a|
00002100  64 64 72 65 73 73 65 73  20 69 6e 20 74 68 65 20  |ddresses in the |
00002110  6d 6f 64 75 6c 65 20 61  6e 64 0a 63 6f 6d 6d 61  |module and.comma|
00002120  6e 64 20 69 6e 66 6f 72  6d 61 74 69 6f 6e 20 77  |nd information w|
00002130  69 6e 64 6f 77 73 2e 20  20 41 62 73 6f 6c 75 74  |indows.  Absolut|
00002140  65 20 63 61 75 73 65 73  20 74 68 65 20 61 64 64  |e causes the add|
00002150  72 65 73 73 65 73 20 74  6f 20 62 65 20 73 70 65  |resses to be spe|
00002160  63 69 66 69 65 64 0a 61  73 20 74 68 65 20 61 63  |cified.as the ac|
00002170  74 75 61 6c 20 6d 65 6d  6f 72 79 20 61 64 64 72  |tual memory addr|
00002180  65 73 73 2e 20 20 52 65  6c 61 74 69 76 65 20 63  |ess.  Relative c|
00002190  61 75 73 65 73 20 74 68  65 20 61 64 64 72 65 73  |auses the addres|
000021a0  73 65 73 20 74 6f 20 62  65 20 64 69 73 70 6c 61  |ses to be displa|
000021b0  79 65 64 0a 61 73 20 61  6e 20 6f 66 66 73 65 74  |yed.as an offset|
000021c0  20 66 72 6f 6d 20 74 68  65 20 73 74 61 72 74 20  | from the start |
000021d0  61 64 64 72 65 73 73 20  6f 66 20 74 68 65 20 6d  |address of the m|
000021e0  6f 64 75 6c 65 20 69 6e  20 6d 65 6d 6f 72 79 2e  |odule in memory.|
000021f0  0a 54 68 65 20 62 75 74  74 6f 6e 73 20 61 74 20  |.The buttons at |
00002200  74 68 65 20 62 6f 74 74  6f 6d 20 6f 66 20 74 68  |the bottom of th|
00002210  65 20 6f 70 74 69 6f 6e  73 20 77 69 6e 64 6f 77  |e options window|
00002220  20 65 66 66 65 63 74 20  74 68 65 20 77 61 79 20  | effect the way |
00002230  69 6e 20 77 68 69 63 68  20 74 68 65 0a 6f 70 74  |in which the.opt|
00002240  69 6f 6e 73 20 61 72 65  20 61 70 70 6c 69 65 64  |ions are applied|
00002250  2e 20 20 43 61 6e 63 65  6c 20 69 67 6e 6f 72 65  |.  Cancel ignore|
00002260  73 20 61 6e 79 20 63 68  61 6e 67 65 73 20 6d 61  |s any changes ma|
00002270  64 65 20 74 6f 20 74 68  65 20 73 65 74 74 69 6e  |de to the settin|
00002280  67 73 2e 20 20 4f 4b 0a  61 70 70 6c 69 65 73 20  |gs.  OK.applies |
00002290  74 68 65 20 73 65 74 74  69 6e 67 73 20 74 6f 20  |the settings to |
000022a0  74 68 65 20 63 75 72 72  65 6e 74 20 73 65 73 73  |the current sess|
000022b0  69 6f 6e 2e 20 20 53 61  76 65 20 77 69 6c 6c 20  |ion.  Save will |
000022c0  61 70 70 6c 79 20 74 68  65 20 73 65 74 74 69 6e  |apply the settin|
000022d0  67 73 0a 61 6e 64 20 61  6c 73 6f 20 73 61 76 65  |gs.and also save|
000022e0  20 74 68 65 6d 20 69 6e  20 74 68 65 20 61 70 70  | them in the app|
000022f0  6c 69 63 61 74 69 6f 6e  27 73 20 64 65 66 61 75  |lication's defau|
00002300  6c 74 73 20 66 69 6c 65  20 61 6c 6f 6e 67 20 77  |lts file along w|
00002310  69 74 68 20 74 68 65 20  63 75 72 72 65 6e 74 0a  |ith the current.|
00002320  73 65 74 74 69 6e 67 20  6f 66 20 64 69 73 70 6c  |setting of displ|
00002330  61 79 20 73 69 7a 65 2e  20 20 54 68 69 73 20 66  |ay size.  This f|
00002340  69 6c 65 20 69 73 20 72  65 61 64 20 77 68 65 6e  |ile is read when|
00002350  65 76 65 72 20 74 68 65  20 61 70 70 6c 69 63 61  |ever the applica|
00002360  74 69 6f 6e 20 69 73 0a  73 74 61 72 74 65 64 2e  |tion is.started.|
00002370  20 20 44 65 66 61 75 6c  74 20 77 69 6c 6c 20 61  |  Default will a|
00002380  70 70 6c 79 20 74 68 65  20 64 65 66 61 75 6c 74  |pply the default|
00002390  20 73 65 74 74 69 6e 67  73 20 77 68 69 63 68 20  | settings which |
000023a0  61 72 65 20 68 61 72 64  77 69 72 65 64 20 69 6e  |are hardwired in|
000023b0  74 6f 0a 74 68 65 20 70  72 6f 67 72 61 6d 20 2d  |to.the program -|
000023c0  20 6e 6f 74 20 74 68 6f  73 65 20 77 68 69 63 68  | not those which|
000023d0  20 61 72 65 20 73 74 6f  72 65 64 20 69 6e 20 74  | are stored in t|
000023e0  68 65 20 64 65 66 61 75  6c 74 73 20 66 69 6c 65  |he defaults file|
000023f0  2e 0a 0a 0a 53 68 6f 72  74 20 74 65 63 68 6e 69  |....Short techni|
00002400  63 61 6c 20 6e 6f 74 65  0a 2d 2d 2d 2d 2d 2d 2d  |cal note.-------|
00002410  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 0a 54  |-------------..T|
00002420  68 69 73 20 61 70 70 6c  69 63 61 74 69 6f 6e 20  |his application |
00002430  69 6e 74 65 72 63 65 70  74 73 20 74 68 65 20 68  |intercepts the h|
00002440  61 72 64 77 61 72 65 20  53 57 49 20 76 65 63 74  |ardware SWI vect|
00002450  6f 72 20 69 6e 20 6f 72  64 65 72 20 74 6f 20 6d  |or in order to m|
00002460  6f 6e 69 74 6f 72 0a 4f  53 5f 4d 6f 64 75 6c 65  |onitor.OS_Module|
00002470  20 53 57 49 20 63 61 6c  6c 73 2e 20 20 54 68 69  | SWI calls.  Thi|
00002480  73 20 6d 61 79 20 63 61  75 73 65 20 70 72 6f 62  |s may cause prob|
00002490  6c 65 6d 73 20 69 66 20  61 6e 6f 74 68 65 72 20  |lems if another |
000024a0  61 70 70 6c 69 63 61 74  69 6f 6e 0a 61 74 74 65  |application.atte|
000024b0  6d 70 74 73 20 74 6f 20  64 6f 20 61 20 73 69 6d  |mpts to do a sim|
000024c0  69 6c 61 72 20 74 68 69  6e 67 2e 20 20 54 68 69  |ilar thing.  Thi|
000024d0  73 20 69 73 20 6e 6f 74  20 72 65 61 6c 6c 79 20  |s is not really |
000024e0  6d 79 20 66 61 75 6c 74  2c 20 62 75 74 20 69 73  |my fault, but is|
000024f0  20 64 75 65 20 74 6f 0a  41 63 6f 72 6e 20 6d 61  | due to.Acorn ma|
00002500  6b 69 6e 67 20 53 57 49  20 61 20 68 61 72 64 77  |king SWI a hardw|
00002510  61 72 65 2c 20 72 61 74  68 65 72 20 74 68 61 6e  |are, rather than|
00002520  20 73 6f 66 74 77 61 72  65 20 76 65 63 74 6f 72  | software vector|
00002530  20 28 49 20 74 68 69 6e  6b 29 2e 0a 0a 0a 57 61  | (I think)....Wa|
00002540  72 6e 69 6e 67 3a 0a 0a  54 68 69 73 20 70 72 6f  |rning:..This pro|
00002550  67 72 61 6d 20 63 61 6e  20 75 6e 70 6c 75 67 20  |gram can unplug |
00002560  6d 6f 64 75 6c 65 73 20  74 68 61 74 20 79 6f 75  |modules that you|
00002570  20 6d 61 79 20 72 65 71  75 69 72 65 20 74 6f 20  | may require to |
00002580  72 75 6e 20 63 65 72 74  61 69 6e 20 0a 61 70 70  |run certain .app|
00002590  6c 69 63 61 74 69 6f 6e  73 2c 20 6f 72 20 70 72  |lications, or pr|
000025a0  6f 67 72 61 6d 73 2c 20  73 6f 20 62 65 20 76 65  |ograms, so be ve|
000025b0  72 79 20 63 61 72 65 66  75 6c 20 77 68 65 6e 20  |ry careful when |
000025c0  75 73 69 6e 67 20 74 68  69 73 20 70 72 6f 67 72  |using this progr|
000025d0  61 6d 20 61 73 0a 77 65  20 63 61 6e 6e 6f 74 20  |am as.we cannot |
000025e0  62 65 20 68 65 6c 64 20  72 65 73 70 6f 6e 73 61  |be held responsa|
000025f0  62 6c 65 20 66 6f 72 20  61 6e 79 20 65 72 72 6f  |ble for any erro|
00002600  72 73 20 79 6f 75 20 6d  61 6b 65 2e 0a 0a        |rs you make...|
0000260e