Documentation for Bedit - RISCOS BAsic Editor

Copyright Brian Smith
'bsmith' on CIX conferencing system (01-399-5252)
MBX 719992779 on Prestel

This RISCOS application is provided as a simple example of using the multi-
tasking facilities to provide useful utilities.  The program is very simple, 
and requires minimal memory.

The ARC file contains the following files:

    BEdit_Doc         this text file
    !Run              program startup obey file
    !sprites          sprite for icon bar
    BEDIT             main BASIC program using Wimp calls
    BED               subsidiary program used to invoke the Editor

All the files should be placed in a new RISCOS application directory,
ideally called !Bedit - the ! in front of the name is mandatory.

When you run the desktop, and display the directory containing !Bedit, it
should show the Bed icon (the kind you sleep on).  Clicking on the application
directory should place a Bed icon on the icon bar. That's all that happens
for now.

To edit a BASIC file, open the directory from the desktop, and drag the 
file icon onto the BED - you should then find yourself in the normal
BASIC editor, with the file loaded.  If this doesn't happen, there are
2 probable causes:

  1.  the BasicEdit module could not be located (wrong directory specified
      in the !Run file). Use !ARCEdit to change the RMload instruction
      in the !Run file appropriately.

  2.  no room in RMA - use Desktop Task Dislay to increase memory assigned
      to modules, then try again.

Because the standard BASIC editor is not a wimp application, all multitasking
is suspended whilst editing the file. When you quit the editor (Shift-F4), type
QUIT to leave BASIC (ensuring you have saved your file first).
You will then be prompted to press a key or mouse button, which will cause 
the Desktop to re-appear as you left it.

Clicking on the MENU button with the mouse pointer over the BED icon will
invoke a menu with two options:
       Quit   - to remove BED from the desktop
       New    - to create a new BASIC program with the editor.

Any improvements or bugs should be notified to me, either via CIX, or by
snail-mail at:  52 Leazes Avenue,
                Chaldon
                Caterham
                Surrey  CR3 5AH

Have fun.

