Install -  Carl Anthony Edwards - Thursday, 28th March 1991

This routine simply allows you to easily compile assemply language routines
in the form of BASIC functions into a program. Simply append this on to the
main assembly source code program.

Usage :

At either the start or end of the code type;

  FNinstall(section$,name$)     where section$ is the routine's section name
                                      name$ is the name of the routine

This will install the routine into memory and call a function which should
be in this routine. This function should also be called name$. For the sake
of convention the defined routine should also be called this eg a routine
called 'shiftdata' in the 'memory' section should contain an initialising
function called 'FNshiftdata' and should be called using 'BL shiftdata' or
equivalent.

Note :

Because this routine calls a function specifed by the second parameter of
the variable, it is important that the case used matches that in the
function's title. The case used in the filename is irrelevant though the
name must be the same.

Example :

  DIM block 256
  P%=block
  [OPT 2                               \ Tell computer assembly code follows
  :                                    \
  FNinstall("Memory","shiftdata")      \ Install "Memory.Shiftdata" from the
  :                                    \ library and call FNshiftdata
  ALIGN                                \
  .return EQUD 0                       \ Set up return pointer
  .main                                \
  STR R14,return                       \ Store return pointer
  ADR R0,sourcemem                     \ Initialise registers for shiftdata
  ADR R1,destmem                       \ routine (see Shiftdata documents
  MOV R2,#32                           \ for further information)
  BL shiftdata                         \ Call shiftdata routine
  LDR R14,return                       \ Reload return pointer
  MOVS R15,R14                         \ Exit
  ]

  CALL main                      : REM \ Call machine code just defined.
