                        The new RISC OS Window Manager
                        
Introduction
============
        The new RISC OS Window Manager or Wimp has the following improvements
over the RISC OS 3.10 one:

        - Can use any outline font at any size in menus and icons
        
        - Has a 'watchdog' for stopping rogue programs
        
        - Can tile window backgrounds with an arbitrary sprite

        - Improved error handling
        
We recommend the use of a standard font such as Homerton Medium or Trinity Medium at
12 point, although many other combinations will work ok. On TV resolution screens (eg.
modes 15 and 39) a special tuned bitmap is available in 12 point called darwin.medium.
This is installed automatically into Resources:$.Fonts.

Installing
==========
        You should first copy the supplied modules onto your harddisk (we do not recommend
using the new system on floppy only computers) into a suitable directory (eg. $.RM or
$.!system.modules). Note that they cannot be run directly (as the window manager cannot be
reloaded whilst in use) but the boot behaviour must be altered.
        You will probably already have a !Boot file, if this loads other modules then
starts the desktop you can just add the new modules. If this file is a desktop command
file though, it will need renaming, eg. to !DeskBoot. Your !Boot file should look like
this:
        ...
        rmload $.rm.Filer
        rmload $.rm.Wimp
        rmload $.rm.WimpROMRes
        rmload $.rm.Pinboard
        rmload $.rm.DragASprit
        ...
        desktop -file !DeskBoot
        
Then Reset the computer. If all is well then the desktop should start as usual (though
note that the welcome banner has altered) with the standard system font.

Note: If you have your own Wimp Resources (pointed to by WindowManager$Path), the wimp
now uses Template3D as its template file. Also the messages have changed. Using the old
resources on the new system will cause problems.

Setting Up
==========
        In order to use the new features, some variables must be set up (or use !SysFont
to set the font):

        Wimp$Font               should be set to a valid font name
        Wimp$FontSize           is the size in 16ths of a point
        Wimp$FontWidth          is the width in 16ths of a point
        
Note that the width is optional, if ommitted, then the size is used. If the size is
not set the a value of 204 is used (about the same size as the old system font).

Examples:
        Set Wimp$Font Homerton.Medium
                this will make the desktop environment use homerton medium at 12.75 points
                
        Set Wimp$Font Trinity.Medium
        Set Wimp$FontSize 192
        Set Wimp$FontWidth 160
                this will use Trinity medium at 12 point, but only 10 point wide, ie 
                slightly narrower than usual.
                
        Obviously these variables may be setup in the !Boot file, rather than typing
them in each time. We recommend that you use !SysFont until you're happy with a 
particular font, then set this up in the !Boot file (not the !DeskBoot file).
                
        To use the window tiling, the sprite 'tile_1' must be loaded into the Wimp's
sprite area (eg. by using *iconsprites). Whenever a window has background colour 1 the
wimp will then tile the given sprite across the window before drawing any icons. This
works best when the sprite to be used was created in the display mode (or similar) as
otherwise the wimp must translate the sprite before plotting, which will obviously
slow the system down.

        The watchdog requires no setting up and is described in the 'In use' section below
                
In  Use
=======
        The desktop should appear much as before and the user should have no difficulty
in using it. Note that the Filer now automatically calculates the width of the columns in
the viewers to accomodate wide filenames, eg. ones with lots of capitals. The minimum 
width is defined in the template file for the Filer.

        To use the watchdog, press the Break key. A dialog will appear asking if you wish
to stop a named task. If you don't press the Cancel button, if you do press the Stop/Kill
button. If you wish to end a different task, then press the Next Task button until the
one you want is displayed.