Toolbox & System update, including possible problems and remedies
-----------------------------------------------------------------
Updated: 2000.06.07

If you have RISCOS 4 the installation process should mean that your
Toolbox modules (in ROM) and boot sequence are properly up to date and
!InstallPC will not need to make any changes to you system apart from
installing it own files. Hoever !UpdateSys is RISCOS 4 aware and should
be able to sort out any toolbox problems that it finds.

Many RISCOS 3.X systems need some reconfiguration to work properly with
PCPro. Here we describe what is required by !PC, what !UpdateSys tries to
do, and what you should do if you encounter problems during the upgrade.

Almost all Toolbox modules should be installed in
!Boot.Resources.!System.310.Modules. This is because the modules will
work with RISCOS 3.10 or later. The only exception is Textgadget, which
should be in !Boot.Resources.!System.350.Modules. There should not be any
Toolbox modules in other folders like .360.Modules,
.370.Modules or .Modules. Also if you have RISCOS 3.60 or 3.70 the older
Toolbox modules in the ROM should be unplugged - the UnplugTbox utility
is needed to do this. To ensure that all the 310,350,360,370 etc
directories exist, and the the System: variable is set to point to them
in the correct sequence you need a 'new style' boot structure.

!UpdateSys tries to unsure all of these things by:
1) Creating the '310' etc folders and 'Modules' subfolders if they aren't
   present, and copying up-to-date !Boot, !Run, !Help and !Syspaths (from
   !UpdateSys.NewSystem) into !Boot.Resources.!System.
2) Checking to see if you have UnplugTBox in either !Boot.utils, or
   !Boot.Choices.Boot.Predesk. If not, it is put in .Predesk, unless you
   have RISCOS 4 in which case it doesn't put it in.
3) Moving any toolbox modules in !Boot.Resources.System.Modules, to
   !Boot.Resources.System.310.Modules, so long as they are more recent
   than the ones already there. The same is done for the
   !Boot.Resources.System.400, 370, 360 directories.
4) The suppied toolbox modules supplied with !PC are unzipped into
   !Boot.Resources.System.310.Modules if they are newer than the ones already
   present.
5) If you have RISCOS 3.5 or 3.6 the Toolbox modules in the ROM are
   unplugged to make sure they do not get in the way of the new soft-loaded
   ones. This is done because the 'UnplugTbox' program does nt always do the
   job.

This process will normally result in everything being up to date and in order
next time you reboot, but there are a number of things that may cause it to
fail. If you have Toolbox modules that have new datestamps but are actually
old modules they may be left when they shouldn't be. If your boot sequence is
broken in some way then paths may be incorrectly set and some of the tests
will fail, or UnplugTbox will not work properly.

If, after running !UpdateSys and rebooting, you are still unable to run
!PCInstall (which checks that everything is now in order), then you can
either try to sort it out manually, using the above information and
'Manual installation and checks' below, or if you have internet access, first
try using the !Upgrader application from Acorn, and then if that doesn't get
you going, work though the 'Manual installation and checks' section.

!Upgrader
---------
This can be downloaded from http://www.acorn.com/browser/download.html

Look for the link to download the toolbox only. It is about 3/4 of the
way down the HTML page. 

It will ask if you are using Acorn's Browser or Java software but in fact it
will only install and update the Toolbox modules, so ignore the question and
continue to install. Then run !InstallPC from floppy.


Manual installation and checks
==============================

RiscOS 3.6, 3.7 and 4 have some or all of the toolbox modules in ROM.
Press Ctrl and F12 on keyboard to obtain a Task window.
Type *ROMmodules 

For RiscOS 4.02
---------------
!PC does not need any modules newer than those provided in ROM, so none
need to be unplugged (although some might be if you have had updates).

100 System ROM  Toolbox                 1.45    Active
101 System ROM  Window                  1.59    Active
102 System ROM  ToolAction              0.17    Active
103 System ROM  Menu                    0.35    Active
104 System ROM  Iconbar                 1.18    Active
105 System ROM  ColourDbox              0.18    Active
106 System ROM  ColourMenu              0.19    Active
107 System ROM  DCS                     1.08    Active
108 System ROM  FileInfo                0.17    Active
109 System ROM  FontDbox                0.17    Active
110 System ROM  FontMenu                0.21    Active
111 System ROM  PrintDbox               0.14    Active
112 System ROM  ProgInfo                0.15    Active
113 System ROM  SaveAs                  0.16    Active
114 System ROM  Scale                   0.14    Active
115 System ROM  TextGadgets             0.19    Active

For RiscOS 3.7 
--------------
Modules from 113 to 126 should be all Unplugged as shown.

113 System ROM  Toolbox                 1.36    Unplugged
114 System ROM  Window                  1.31    Unplugged
115 System ROM  Menu                    0.24    Unplugged
116 System ROM  Iconbar                 1.12    Unplugged
117 System ROM  ColourDbox              0.15    Unplugged
118 System ROM  ColourMenu              0.17    Unplugged
119 System ROM  DCS                     1.06    Unplugged
120 System ROM  FileInfo                0.14    Unplugged
121 System ROM  FontDbox                0.14    Unplugged
122 System ROM  FontMenu                0.17    Unplugged
123 System ROM  PrintDbox               0.09    Unplugged
124 System ROM  ProgInfo                0.09    Unplugged
125 System ROM  SaveAs                  0.12    Unplugged
126 System ROM  Scale                   0.11    Unplugged

For RiscOS 3.6
--------------
Modules from 108 to 121 should all be Unplugged. Same as shown for 
RiscOS 3,7 above but some will have differing module version numbers.

Unplug ROMmodules.
------------------
In the Task Window (Press Ctrl and F12 on keyboard) for any modules not 
show as Unplugged need to have the following command typed in.

*Unplug <module name>

<module name> is the name of the module that is not Unplugged.

When complete, shutdown and hard reset. Use Task Window (Press Ctrl and 
F12 on keyboard) and *ROMmodules command to ensure that the modules
remain Unplugged.

If not then there must be a program that is stopping or reinstalling the 
ROMmodules in !Boot. 

!System modules.
----------------
Before making any changes to !System create a Backup directory on the 
harddrive and make a copy of !System in it. To open up any "!"Application 
hold down shift on the keyboard and double-select with the left hand mouse
button.

You will find !System at.

!Boot
     Resources
              !System 

Set Access rights by pressing the Mouse Menu button (Middle) while the 
mouse pointer is on !System. 
Follow the App. '!System'> to open the Application Menu.  
Follow the Access> to open the Access Menu.
Go down and follow Access details> to open up the Access details Menu.
>From the menu 
Select "No" for Locked
Select "Yes" for Owner read, Owner write, Public read, and Public write.
ensure that "Recurse" is ticked before pressing OK.

Open up !System using the shift on the keyboard and double-selecting with 
the left hand mouse button. You should find that you have several 
directories.

The only location where the directory called toolbox should be found is in

!System
       310
          Modules

As you should have followed previous instructions and have a back up of
!System then you may delete all other toolbox directories and their contents.

Re Run !UpdateSys.
------------------
Put PCPro3 floppy in to floppy drive select !UpdateSys.

Other Software
--------------
Some other software may need some of the other modules in the copy of 
!System. Only put modules back that are needed by other software and do not 
just randomly take modules from the backup.

SysPath problems 
----------------
All you have to do is ensure that the
 
!System
       SysPaths

is later than 24-Mar-1995 by pressing the Mouse Menu button (Middle) 
while the mouse pointer is on SysPaths. 
Follow the File 'SysPaths'> to open the File Menu.  
Go down and follow Info> to open up the 'About this object' dialogue box, so
that you can read the date. 

If all else fails
-----------------
If and you still have problems it will be because of clashes in your !Boot 
structure. In that case you will need to start from a new !Boot and update
using !Upgrader, adding items from your old !Boot until you can find the 
offending item. 

New !Boot's are available from SA CD, AU200 CD or download from Acorn 
using the link shown above.
 