------------------------------
                 ModelWorks Windows 2.2 Alpha-1
                 ------------------------------

This is the second alpha release of ModelWorks for Windows 2.2. It is provided
for testing purpose onlys, but is fairly stable. The users must be familiar
with the Logitech Modula 2 V4.0 environment.


RESTRICTIONS:
Some functions are not implemented. You will get a "Sorry not implemented"
message, while calling such a function (See SECTION 'RESSOURCES').
No special documentation is included yet. Please use the Macintosh ModelWorks
Manual. The ModelWorks Windows version will work with Windows 3.1, Windows 95,
Windows NT, but NOT with Windows 3.0.


DOCUMENTATION:
There are several documents included in this distribution, all in plain
text format (except for the DialogMachine-documentation 'ON_DM.RTF' which
is stored in RTF-Format, so you should be able to open it with a standard
word-processing application like MS Word etc.)


INSTALLATION:
- You need Logitech Modula 2 V4.0 Support Release 3 installed and properly
  initialized on your disk in order to use this package.

- Just download the MW22a1.exe file. It is a self-extracting archive.
  Upon execution it will generate a tree on your disk starting at \MW.

- Add the appropriate path information to include ModelWorks in your
  environment. You can use the batch-file \MW\SETVAR.BAT to set
  up ModelWorks-environment.

- \MW\LIBRARY.MAK must reside in the default directory or must be in your path.
  It helps the Logitech environment to find the ModelWorks libraries.


TO COMPILE THE SAMPLE MODELS:
- Go to the directory where the sample models reside (\MW\SAMPLES) and
  run the batch-file MAKESAMP.BAT to build all sample models or
  MAKE MODEL to make just one of the simple models (where MODEL stands
  for a sample model file - e.g. to build Logistic-Model, type
  MAKE LOGISTIC).
  Like this, you can create an executable file for each sample model.


TO COMPILE YOUR OWN MODELS:
- The easiest way to compile your own models is to use the batch file
  'MAKE.BAT' which resides in the directory \MW\SAMPLES and
  proceed like for the sample models.


WHAT FILES ARE USED?
The things you need to get your own model up and running are:
- A module-definition file for Logitech Linker
     There is a sample module-definition file included ('MW.WDF'), that
     should do for your models (and will of course for the sample models).
     Plese refer to the Logitech compiler manual for more information.

- A Logitech-project-file (e.g. MW.PRJ), that helps the Logitech environment
  to compile and link the files needed.
     There is a sample project-file included in this distribution (MW.PRJ),
     that helps you compile all sample models and probably most of your
     own models. The batch-file 'MAKE.BAT' mentioned above, uses this
     sample project file to compile the sample models.
     Please refer to Logitech documentation, if you want to understand
     what's really in this project file.

- An INI-file that helps ModelWorks to map the used fonts into the available
  windows fonts.
     There is a sample RC-file included. You can edit it to fit your needs.

- A Ressource-File for the Resource-Compiler
     There is a Sample ressource file include (\MW\RES\MW.RC) that will
     do for simple models. (See SECTION 'RESSOURCES').


RESSOURCES
The ressource file used for building ModelWorks-applications contains
3 different parts (please refer to Windows documentation, or look at the
sample ressource file \MW\MW.RC):

 The stringtable-entries are:
        - String 100: The title of your application
        - String 101: A Number which will enable or disable the
                'SorryNotImplemented' messages.
                > 5: will disable all 'SorryNotImplemented'-messages
                <=5: will enable all 'SorryNotImplemented'-messages of the
                     not implemented DialogMachine-functions
        - String 102: Will let you choose a different INI-File for Font-Mapping
                and ressource-saving (predefined menus and stored strings).

 The DMICON section lets you select an icon of your choice.

 The MACPIC section is needed to display buttons in ModelWorks-Models (please
 make shure the SIMMASTE.PIC-file is proparly included as in the sample
 ressource file \MW\MW.RC)

 To use predefined pictures in your ModelWorks application, you can
 add a numbered sections to your RC-file.
               [PICTURE-Nr.] BITMAP [BITMAP-File]
 e.g. "3133 BITMAP \MW\RES\3133.bmp"

 This will enable you to call the function 'DisplayPredefinedPicture' from
 DMWindIO-module in your model source file. E.g.
 "DisplayPredefinedPicture('', 3133, f);"
 The named file must exist and be a standard Windows-bitmap file!


BUG REPORTS and SUGGESTIONS:
Please contact us at: modelworks.pc@ito.umnw.ethz.ch

Thomas Wegmueller, 17. Sept. 1996