  > MususUtils - Version 1.04 (full version - included here)
  > MususUtils - Version 0.01 (lite version - as used in !Angband, etc).

  By Musus Umbra <musus@argonet.co.uk> http://www.argonet.co.uk/users/musus/

  ----------------------------------------------------------------------------
  (c) 1998/9, all rights reserved.  No warranty, express or implied, is
  provided.  Under no circumstances can the authors be held responsible
  for any loss/damage sustained as a result of the use, misuse, or inability
  to use this software.  Bug reports are, however, welcome.
  ----------------------------------------------------------------------------
  Updated to be 32-bit clean by Harriet Bazley, 2003, with permission.
  ----------------------------------------------------------------------------

  NB: The full source code for these modules is available on request.

  Two versions of this module exist, the normal one and a cut-down 'lite'
  version created for use with my Angband ports.  Both versions have the same
  name ("MususUtils") but the 'lite' version has a lower version number than
  any full version, which leads to a RMEnsure of the form:

     RMEnsure MususUtils 1.02 RmEnsure MususUtils 0.01 RMLoad <obey$dir>.MUlite

  in the Angband ports.  Hopefully this makes sense.

  MususUtils is a little utility module that provides some commands
  originally intended to make life easier for my Angband ports.  Most of
  them have many other applications, however.

  Some commands duplicate (or closely mimic) commands already available in
  later versions of RISC OS;  this is largely because I wanted/needed to use
  those commands without worrying about what version of RISC OS the machine
  was running, etc.

  Commands provided by the both the full and Lite versions are marked [Lite].
  All other commands are available only in the full (non-lite) version.

  Where I can remember, I've included the earliest version of the module
  that supports a particular command.  Note that if two version numbers
  are given the first refers to the full version and the second to the
  'lite' version.  Commands with no version number stated exist in all
  versions of the module(s).


  Commands provided:

        *MususDo           [Lite]
        *MususHourglass
        *MususIconsprites  [Lite]
        *MususIfKey        1.01
        *MususIfNewer      1.02
        *MususIfThere      1.03
        *MususIfType       1.02
        *MususInput        1.02
        *MususLoadCMOS     1.04
        *MususSaveCMOS     1.04
        *MususXOS          1.01


  Individual Commands:

  *MususDo
        Passes its argument to the CLI after GSTransing its arguments

        Syntax: MususDo <*command>


  *MususHourglass
        Turns the hourglass on/off.

        Syntax: MususHourglass On | Off


  *MususIconSprites
        Issues a *iconsprites command taking into account the screen
        resolution (only really useful for RISC OS 2).

        Syntax: MususIconSprites <filename>


  *MususIfKey
        Executes its argument (via OS_CLI) if the specified key (given as
        an internal key number) is pressed. (see PRM 1-849 or StrongHelp
        OS manual under OS_Byte 121).

        Syntax: MususIfKey <key number> <*command>


  *MususIfNewer
        Will execute a specified command if, and only if, the specified object
        'a' has a newer timestamp than object 'b'.

        Non-existent files are presumed to be infinitely old.

        Syntax: MususIfNewer <object_a> <object_b> <command>


  *MususIfThere
        Will execute a specified command if, and only if, the named object
        exists.

        Syntax: MususIfThere <filename> <command>


  *MususIfType
        Will execute a specified command if, and only if, the specified
        object exists and has the specified filetype.

        Directories (be they applications or not) have filetype &1000,
        untyped files have filetype &1001. Missing files have filetype
        &1002 and 'errors' filetype &1003.

        Use the -i switch to force image files to be considered as directories.

        Syntax: MususIfType [-i] <filename> <type> <*command>


  *MususInput
        Reads a line from the keyboard (using OS_ReadLine) and sets the
        specified system variable to the hold the string
        read.

        An (optional) prompt may be specified.

        Syntax: MususInput <variable> [<Prompt>]


  *MususLoadCMOS
        Sets the CMOS RAM settings from the values stored in the named file.

        If -reset is specified the machine will then be reset (RiscPC only).

        Syntax: MususLoadCMOS [-reset] <filename>



  *MususSaveCMOS
        Saves the current CMOS RAM settings to the named file.

        Syntax: MususSaveCMOS <filename>


  *MususXOS
        Executes its argument (with XOS_CLI) and does not return any errors
        if the command fails for any reason.

        Syntax: MususXOS <*command>

