

                MicroHope for the Acorn Archimedes

    Imperial College of Science, Technology and Medicine, 1989


          Ported to the Archimedes by Michael Ben-Gershon
                 Version 4.02A, 19th December 1989









Some hints and application notes for the Archimedes version of MicroHope:



!Help files:

    This file is named !Help.  If a filer menu is produced for an
    application directory and there is a file in the directory named !Help,
    a further option will appear in the menu - namely 'Help'.  Clicking on
    this option will attempt to 'run' the !Help file.  Usually it will have
    a filetype of &FFF (text) so it will be loaded into '!Edit'.



!Hope documentation:

    If you download the Hope documentation (which you should even if you've
    used IC-HOPE before, as the Archimedes version has some extensions
    added), you might find it helpful to rename the Hope 'HopeArchie' file
    to '!Help' and then put it into the !Hope application directory.  That
    way you will always know where to find basic help on Hope, even though
    you won't be able to use it when using Hope, unless you are running it
    in an Edit task window.  If this is not the case, it could be viewed
    using:

                   system "type <Hope$Dir>.!Help";



Preparation of Hope source code:

    It is recommended that you use an editor such as '!Edit' or 'Twin' for
    composing Hope source code.  Typing 'on line' is OK for short tests on
    functions, but is limited because the 'save' routine removes all
    comments AND INFIX DECLARATIONS - meaning that some programs will not
    work at all if saved and later reloaded!



Archimedes 'Application Shell':

    To increase productivity, a small 'application shell' has been written.
    If the !Hope application directory is installed on the icon bar as a
    'TinyDir', text files DRAGGED onto it will cause the Hope system to be
    initialised with that file loaded automatically.  This process is
    speeded up for long programs if the file contains an 'echo off;' at its
    start.  Double clicking on the icon itself will enter Hope with no file
    loaded.  In both cases the current directory is set to
    <Hope$Dir>.Programs and is displayed at the top of the screen.  The
    directory is restored on exit.  Within the !Hope application is an obey
    file named '!HopeEdit' (which may be installed as a 'BackDrop' file if
    you have 'BackDrop').  Double clicking on it will open a Filer window
    showing the files in <Hope$Dir>.Programs.

    The 'WimpSlot' command in !Run is set to 'WimpSlot -min 300k'.  It
    should allocate enough memory for very simple programs.  It should be
    adjusted upwards for memory hungry programs (especially deeply recursive
    ones!) as 300k is an ABSOLUTE minimum.  Hope itself has been 'squeezed',
    so its file-length is deceptive!  It can get VERY memory-hungry, and if
    it seems to crash, try enlarging the 'Next' slot on the Task Manager
    display before trying again.



Printing from MicroHope:

    Output from Hope may be printed by entering <control>B before, and
    <control>C after the output to be printed.  The printing width may be
    set, if desired, using the 'width' command.  Alternatively, Hope may be
    run from an '!Edit' or 'Twin' task window, and printed from there.




Sample Programs:

    Some sample programs are included with MicroHope.  Some of them are
    better documented than others, but all should be easy to follow after
    reading the Hope Tutorial.





Information:

    Archimedes MicroHope
    Version 4.02A

    Ported (with extensions) by:
      Michael Ben-Gershon
      8 Linnell Drive
      LONDON NW11 7LT

    No telephone calls please.

    However, I can be contacted as:
    Prestel (and SID):  014554781
    Janet:              umace03@doc.ic.ac.uk
    Archive:            Michael Ben-Gershon (396)
