TURBO SUPER MONITOR RAZORMAID MIX 1994
                     --------------------------------------

English DOC file. 01.08.94 Antoine Pitrou


    Hello! I am proud to present you my new utility,  the  Turbo  Super  Monitor
Razormaid Mix 1994. I have written it especially for assembler  programmers  and
demomakers, for whom the Super Monitor 1.4+ (by Crown) wasn't adapted  to  their
needs. It was coded with the Dams assembler in one week. The source  code  makes
26 Kb and is 3300 lines long.

    The Turbo Super Monitor Razormaid Mix 1994 is freeware, you can copy and use
it as you want, the only condition is that you mustn't change  the  program  nor
this DOC file. If you wanna contact me about bugs, advice or anything else, then
here is my address:

    Antoine Pitrou
    4 rue d'Amsterdam
    F-59700 Marcq-en-Baroeul
    (France)


                              Main characteristics

 - the second 64 Kb memory bank can be used as the first one, in  a  linear  and
transparent way.
 - the most useful commands of the Super Monitor 1.4+ are present  and  some  of
them have been improved.
 - loading and saving files use special routines which give these operations the
same speed in both 64 Kb memory banks.
 - the screen format is 48x21 characters and the CRTC register 9 is  set  to  3.
Thanx to this, the Super Monitor logs in the  second  half  of  the  video  ram,
leaving the "normal" Ram totally free.
 - thanx to small help messages, the program is easier and safer to use than the
Super Monitor 1.4+.
 - the program uses its own high-speed routines  for  displaying  and  scrolling
text.
 - a RET instruction (&C9) is put in &BB5A in order not to  disturb  the  screen
with Amsdos error messages.
 - data input is much more comfortable than on the Super Monitor 1.4+.
 - one part of the video ram is used as buffer for  the  catalogue  command,  so
that the normal Ram isn't modified....
 - swapping drive is made through one special commando (see lower), so that  you
don't need to launch an RSX.


                                  Installation

    This is certainly the strong point of the Turbo Super Monitor Razormaid  Mix
1994: instead of being logged in the central Ram, it is  logged  in  the  second
half of the screen area (from &E000). That's why the size of the screen is  half
as normally.... Be careful 'cause you can't come back under the  system  without
erasing the Turbo Super Monitor Razormaid Mix 1994.

    There are several possibilities to run the Turbo Super Monitor Razormaid Mix
1994....

    Under the Basic: you can type simply RUN"-smon. But then the system will  be
initialized and the decruncher will  first  log  in  the  central  Ram,  erasing
previously present Datas. So you can also change the loading address  by  making
LOAD"-smon",addr:CALL addr. The decruncher can be relocated as it is this of the
Cheese Cruncher....

    Under a hacking interface: load the file to the address you want, then  make
a CALL at the loading address.

    I think that it would be better to make a list of all memory areas  used  in
the first memory bank:

    &0000-&003F: Restart jumps
    &0040-&AB7F: FREE
    &AB80-&ABFF: Roms-switching routines of the Turbo  Super  Monitor  Razormaid
Mix 1994.
    &AC00-&B0FF: Amsdos Ram area
    &B100-&BDFF: Kernal Ram area
    &BE00-&BE7F: Amsdos Ram area
    &BE80-&BF7F: FREE
    &BF80-&BFFF: Z80 stack
    &C000-&DFFF: screen memory
    &E000-&FBFF: machine code of the Turbo Super Monitor Razormaid Mix 1994
    &FC00-&FFFF: buffer used by the Turbo Super Monitor Razormaid Mix 1994

You may have noticed that nearly 43 Kb are free in the first memory bank,  which
is more than the usual memory length. As the 2nd memory bank is  entirely  free,
the total free memory length is 107 Kb !!!


                           Short commando describtion

    When not mentioned, all commandos work in  the  currently  connected  memory
bank.

A - Ascii: the memory is dumped into Ascii symbols

C - Compare two memory blocks; the non-corresponding addresses will be displayed

D - Disassemble.

E - Search for Soundtrakker modules (in the whole connected memory  bank);  this
will also display the real implantation address.

F - Find: after entering the addresses, enter 'B' to search for a list  of  hexa
bytes or 'S' to search for an alphanumerical string. You can  enter  up  to  255
bytes or 30 characters.

H - Header: displays the header datas of the last loaded/saved file.

J - Jump: make a jump to the specified address. This always  works  in  the  1st
bank !! The called routine must end with RET.

L - Load a file: the header will be displayed and you  will  be  asked  for  the
loading address (press Enter for the default address).

M - Memory dump: hex and ascii dump of the memory

N - Memory map: this makes a map of the current memory bank. Dots are made on or
off according to the parity of each byte.

P - Play a Soundtrakker module: you can play a Raw soundtrakker module, but only
in the first memory bank. Type in the beginning address of the  module;  playing
will be stopped with the Esc key.

S - Save file: type in the filename then the datas for  the  file  header.  With
this option you can't save protected files !!!!

V - View memory: you can view the memory as bitmap datas in the specified screen
mode (0-2). The keys are: cursor keys to move start address (slow), +  shift  to
change the size of the window, up/down + control to have  a  fast  move  of  the
start address. After pressing  ESC,  useful  datas  about  the  window  will  be
displayed.... You'll have noticed that the screen size has been changed in order
to view even overscan graphics!

W - Write: this is one of the most powerful functions of the Turbo Super Monitor
Razormaid Mix 1994. With this you can write Hex bytes and  text  in  the  memory
thanks to a powerful page editor a la Maxam  (but  faster).  You  can  move  the
cursor through the memory with the cursor keys, make a fast move with up/down  +
control, and swap between Hex and Ascii zones with TAB.

X - Copy: both memory areas must be in the connected bank. See up and  down  for
copying between different banks.

Z - Fill an area with the specified byte.

Up - copy from 1st bank to the 2nd one
Down - copy from 2nd bank to the 1st one: these commandos can be  launched  only
if the second bank is connected !!

^ - Offset: calculates the offset between the two addresses, to be used  in  the
Z80 Relative Jump instructions.

+ Add two 16-bit numbers. Overflows not detected.
- Same but substraction.
* Multiplication 8-bit by 16-bit.

TAB or ]: swap between the two memory banks.
; switch Roms on/off.
: select upper Rom number (0 = Basic, 7 = Amsdos, others = expansion....)

à - disc catalogue; the screen is used as memory buffer
. - select current drive (A or B)

0 - normal handling
1 - fast handling; this decides whether you must press a key  for  scrolling  or
not.

! - Boot: the Turbo Super Monitor Razormaid Mix 1994 is  initialized:  Roms  are
put off, upper Rom becomes 00 and the connected bank is the 1st one.

CLR - clears screen
ESC - quit the Turbo Super Monitor Razormaid Mix 1994; you  will  be  asked  for
confirmation.