README.TXT for Support Disk Rel. 1.5
TERRA Datentechnik, Tech Support                             04-Aug-92/Bj
-------------------------------------------------------------------------


The support disk is collection of valuable information and
programs related to the new Modula-2 4.0 release. Most of the
hints and examples have been created to clarify and solve
problems we encountered during the beta test phase and our first
experience with the final release. We strongly recommend to
look at its contents carefully so that you can profit from our
experiences when you make your first steps with Modula-2 4.0.


All subdirectories do contain either a file README.TXT describing the
contents of this subdirectory, or a collection of *.TXT files, where we
hope to have chosen meaningful names for the described subjects.


- subdirectory HINTS
  Contains several files with useful information on how to use Modula-2 4.0
  in an optimal way.


- subdirectories CODE1/CODE2/CODE3
  Contains three well documented methods which help you to migrate your 3.40
  modules containing CODE statements to Modula-2 4.0.

  - subdirectory CODE1
    Shows how to convert V3.4 modules using an excellent object to
    ready-for-MASM object file decoder.

  - subdirectory CODE2
    Shows a way to convert the V3.4 object files using the V3.4 M2DECODE
    utility. Additionally it contains some general hints on how to integrate
    an Assembler module into Modula-2 4.0 programs.

  - subdirectory CODE3
    Shows a way to transform Modula-2 sources in a way that the code generated
    by the V3.4 compiler can be linked into V4.0 programs.


- subdirectory M2WINEDI
  Contains a quite complex windows programming example implementing a small
  ASCII editor, and showing you some key programming technics with Modula-2
  under MS Windows.

- subdirectory GRAPHDEM
  Contains an example program showing the usage of the new graphic modules.

- subdirectory BUGS
  Unfortunately has to be there, too. Here you find ASCII files that do
  describe known bugs, and wherever possible a workaround. For a short
  overview about all known bugs see the file BUGLIST.TXT. 
  A sample bug-report sheet (file SHEET.BUG) can be found in this directory.
  If you are unlucky enough to find another bug (which most probably is the
  'very last one'...) please be kind enough to report it on a printout or
  copy of this sheet.

                     THANK YOU.
                     GOOD LUCK AND MUCH FUN WITH MODULA-2 4.0

                     All the best from the TERRA Tech Support Crew

                     BJ/ALG/AKG

  Erlenbach, August 1992
