   _______  __  __  ______   __  __  __  __  ______  _______  ______  _____
  /__  __/ / / / / / ____/  / / / / / / / / / _   / /_   __/ / ____/ / _   /
    / /   / /_/ / / /__    / /_/ / / / / / / / / /    / /   / /__   / /_/ /
   / /   / __  / / ___/   / __  / / / / / / / / /    / /   / ___/  / ___  \
  / /   / / / / / /___   / / / / / /_/ / / / / /    / /   / /___  / /   / /
 /_/   /_/ /_/ /_____/  /_/ /_/ /_____/ /_/ /_/    /_/   /_____/ /_/   /_/

                                 RELEASE 2 
                               
                         Written by Adrian Carpenter

                     VERSION 1.07 (16:35:33 25-Apr-1993)
                                
                       ARMFul & Adrian Carpenter 1993

 
 License
 

 This program is public domain, this software may be given free of charge, 
 although charges may be used for Discs, time and postage and packaging.  
 You may not use this software to obtain source code from commercial 
 programs, and neither may you use this software to break someone else's 
copyright.  Neither I nor ARMFul can accept responsibility for damage to 
 anything through the use or the misuse of the software, no warranty is 
 expressed, implied or anything.  Please note, it is impossible to obtain
 the source code for this program by using 'The Hunter', as the software
 contains a system called 'Stalker' which stops it from being loaded into
 'The Hunter'.  All Source and Object code remains the  Copyright of 
 Adrian Carpenter and ARMFul 1993.  The 'Loader' file is  ARMFul 1993.

 
 About 'The Hunter'
 

 The Hunter started life as a small BASIC program, it was very slow but
 was suprisingley very small in size.  It was written for Adrian Gilby 
 as a program to try to get the !FishDemoS program working, although it
 seemed that the programmers did rather more than I first expected.
 The first versions worked well and provided easy access routines to 
 convert to the ARM Code, which all later versions have been coded in.  
 The Hunter provides some useful functions in manipulating Object code 
 of files, it allows you to extract source code  and remove a SWI of your 
 choice (This function as well, is still to be implemented).  At present
 this program removes OS_UpdateMEMC from machine code programs which mostly
 fails to work on machines fitted with Risc OS3.

 
 Using The Hunter
 

 This version has been provided in an Application directory unlike previous
 versions, this should be loaded like other applications.  The software
 will then take over the whole machine and display the 'ARMFul' Logo
 (By the way the 'Loader' program and ARMFul Logo are  ARMFul 1993), you
 whould now press space and now you will enter 'The Hunter'.

 This version unlike previous versions do not have case sensitive commands,
 so it doesnt matter weather a command is entered as 'L' or 'l' as a small
 routine converts the letter to uppercase anyway.

 On this version a much smaller menu bar has been 'Cooked' up (Thanks go
 to Adrian Gilby for reminding me that the commands should not be case
 sensitive and should correspond to a main letter of the command, earlier
 versions meant if you wanted to load a file you entered 'A'!) so it's
 much easier to select an item.  When 'The Hunter' is invoked you have the
 following choices:

 <L> Load Object 
 <S> Save Menu
 <T> Toggle Print
 <D> Disassemble
 <Q> Quit

 The 'Save Menu' appears at the Command prompt, and it goes something like
 this:

 <O> Save Object
 <S> Save Source

 
 Using The Hunter Part 2
 

 When the Hunter is Loaded, you will get a screen which looks something 
 like the following:

 <L> Load Object    <S> Save Menu      <T> Toggle Print    <D> Disassemble
 <Q> Quit
 -------------------------------------------------------------------------
 Welcome to The Hunter v1.07
  ARMFul & Adrian Carpenter 1993
 Command:>

 
 The Commands above stay up to top of the screen all of the time, this is
 so you don't forget which one to use!

 
 How to use the Commands 
 

 <L> Load Object
 ---------------

 This command Loads up a file, before any commands can be used (With the
 exception of Toggle Print and Quit), when this command is used you should
 be greeted with the following prompt:

 Filename:

 At this point you should type in the name of the file which must be in the
 CSD.  If you hit L by mistake, simply press return and no hard will be 
 done.  Should you type in a invalid filename or the filename of a file
 that does not exist then you will be warned of this with a 'File not found'
 error.

 <S> Save Menu
 -------------
 
 This command brings up a small menu, this is where the commands to save the
 file currently held in the memory are housed, you have the choice of the
 following:

 {

 <O> Object
 ----------
 
 This will save the object code held in the memory.  This is used to save
 a modifed file when the OS_UpdateMEMC has been found and removed (See
 Disasseble) the file should be runnable.

 <S> Source
 ----------
 
 This saves the source as a TEXT (&FFF) file, the file contains all the 
 lines for compiling, so simply load it into BASIC and run it, and you
 will end up with the object code.

 }

 <T> Toggle Print
 ----------------

 This command toggles whether or not the program is displayed when the file
 is dissasmbled.  This is a useful command because a large program will
 have a large listing.  When the listing is on, the program drops it's
 performance quite a lot, so if you simply want to hunt out "OS_UpdateMEMC"
 is suggest that you toggle the state (Press T) until is displays 'Print is
 now off'.

 <D> Disassemble
 ---------------

 This drops you into the Hunters 'VERY SIMPLE' disassembler.  It simply steps
 through where the program is 'Hunting' out 'OS_UpdateMEMC' commands, you
 have no control over the disassembler (Apart from the Toggle Command)
 and it's main use is for looking at Modules to see how certain things
 are done. (For a FULL Disassembler I would reccomend !Diss from DoggySoft
 I have a couple of Demo copies which look very nice indeed, contact 
 DoggySoft on the Digital Databank BBS..In PD Unlimited under Groups (A1).).

 <Q> Quit
 --------

 Err, actually I think this command speaks out for itself!

 ---------------------------------------------------------------------------

 If you have any problems whilst running this program, please contact me and
 I will try my BEST to cure the problem.

 How to contact ARMFul

 We can be contacted on The Digital Databank BBS in PD Unlimited under
 Groups (A3).
 
 We can also be found on Arcade and TWoC.

 