README.TXT for CODE-Statement substitution with Taylor TOBJ2ASM
TERRA Datentechnik, Tech Support                             27-Mar-92/Bj
-------------------------------------------------------------------------

Here you will find an easy and straight-forward method to convert
V3.40 Modula-2 modules which contain CODE-Statements into an
Assembler (MASM 5.1) source file. To do this we use an intermediate
step via decoding of the V3.40 object module.
If you want to do the conversion in this way there is one 'missing link':
The object file decoder.
We are very glad to introduce here the excellent TOBJ2ASM object file
decoder originating from Tayloris Software Zrich. By means of this
program you are able to disassemble any standard Mircosoft object file
into ready to MASM Assembler source files.
You find the manual for this program in the file 'TOBJ2ASM.TXT'.

Please note: The program TOBJ2ASM.EXE, and all related information is
             property of Tayloris Software AG, and must neither be
             reproduced or copied in whole or in part without prior
             written approval from Tayloris Software AG. All rights
             are reserved.


Notes about the development:

To make the conversion as easy as possible you should follow the
hints below:
- Do not convert large V3.40 object files. The best is to isolate
  the few procedures with CODE-Statements in a separate module.
- Compile the V3.40 source without test code.
- Do not use a module body (i.e. initialization code) in the V3.40
  modules to be converted.
- Use as few text/REAL constants as possible.
- Use as few global module data as possible.
- Generally, keep the interface to such a module/procedure as simple as
  possible:
  - few parameters
  - no large value parameters
  - no exported data

The background information to understand these rules can be found
in the comments of the file 'SOUNDSV4.ASM'.

More information about converting V3.4 into Assembler modules interfacing
with V4.0 can be found in the directories 'CODE2' and 'CODE3'.
                                   ***
