IrisRAM v2
==========

IrisRAM will copy Iris to RAM disc for speed, then add it to the Apps icon
on the iconbar.  It will show a banner whilst doing this.  It is designed to
be run during !Boot.

If Iris is then used from RAM disc, it will perform noticeably faster as many common
operations such as font access and library handling are turbocharged.

If IrisRAM is run when Iris is already in RAM disc, the RAM-based Iris will load/run.


Installing
----------

IrisRAM requires a RAM disc of minimum 150 MB to function correctly.
If you haven't configured a RAM disc already, double click on !Boot to open the
Configure window, and go to Discs. Set a suitably sized RAM disc.
On most machines with 2GB+, we suggest a size of 256 MB.

Next, copy !IrisRAM to your main drive, wherever you like.
As of v2 there are minor benefits to copying it alongside !Iris or a directory
lower (eg. in an IrisRAM folder), as this will allow IrisRAM to find !Iris in almost
any location.

Going back to the Configure window (double click on !Boot), go to the "Boot" option then "Run".
Drag !IrisRAM into this window to have it run at startup.

NOTE - Iris will be copied *if it has been seen* or if it is in a known location.  To make it
seen, go to the "Look at" window (alongside "Run") and drop !Iris in from your main drive to
make sure the computer has seen it.


Known locations
---------------

If Iris *hasn't* been seen by the filer, !IrisRAM will look in the following
locations to see if it can find it:

   Apps.!Iris
   Apps.Iris.!Iris
   Network.!Iris
   Network.Iris.!Iris
   Internet.!Iris
   Internet.Iris.!Iris
   Iris.!Iris

   The same folder as !IrisRAM
   or the folder one tier above

You can expand this list by altering !Iris.!Run

All checked locations are on whichever drive holds !Boot.

v2 if !IrisRAM also supports PineBrowse and 4teBrowse if !Iris isn't available


Pinboard
--------

This is a tip for putting the RAM disc version of Iris onto your Pinboard.

Because IrisRAM waits for a tiny moment to display its status window, the !Boot sequence can
progress on behind it, so you can have a chicken/egg situation where IrisRAM hasn't yet
finished copying to RAM disc, but your Pinboard script is run and can't find Iris in RAM.

The solution to this problem is to pin Iris from Apps (Resources:$.Apps.!Iris).  To do this,
click on Apps *on the iconbar* and drag !Iris to the Pinboard, then press menu over the
Pinboard and Save.

To ensure that this works at startup, add the disc-based version of Iris to Apps by double
clicking on !Boot and going to "Boot", then "Add to Apps", then dragging in disc-based !Iris.
When !IrisRAM has copied Iris, it will update the link to point to the RAM copy, and so
the version on the Pinboard will also point at the right place.


Copyright
---------

IrisRAM is (c) Andrew Rawnsley 2022 and published by RISC OS Developments Ltd.
The program is supplied and distributed free of charge to all supporters of 
RISC OS Developments Ltd.  We hope it helps to increase your Iris enjoyment.

