------------------------------------------------------------------------------
Welcome to ModelMaker 4.0 DEMO (build 109)
Copyright  1994-1998 by ModelMaker developers. All rights reserved.
------------------------------------------------------------------------------

This README file contains important, last minute information about ModelMaker 
version 4.0

* Before running ModelMaker 4.0, read the sections UPGRADING and INSTALLATION.

* The complete User Manual and addendums are available for download at our website.
  Here you'll find more information on upgrading and getting started.

------------------------------------------------------------------------------
 1. INTRODUCTION
------------------------------------------------------------------------------

ModelMaker is a powerful full roundtrip CASE-tool and 
component (package) builder for Borland Delphi.
While Delphi is a powerful tool for component based application development, 
ModelMaker is *the* tool for building these components.

------------------------------------------------------------------------------
 2. DEMO RESTRICTIONS
------------------------------------------------------------------------------

The DEMO version of ModelMaker is for evaluation and trial 
purpose only.
The DEMO version has the same functionality as the full version, with the
only restriction that you can not SAVE models:
* containing more than 12 classes, or
* containing classes with more than 12 members.

You can however load bigger models and make bigger models, like the 'Patterns 
Example' in the complete ModelMaker User Manual.

Next to this:
* importing Delphi code will disable code generation.
 

------------------------------------------------------------------------------
 3. MINIMUM SYSTEM REQUIREMENTS
------------------------------------------------------------------------------

ModelMaker 4.0 requires MS Windows 95 or Window NT 4.0, an 80486 or better processor, and 8Mb of system memory. ModelMaker 4.0 has been tested under Window95 and 
Windows NT 4.0.

ModelMaker is designed to work on a high resolution monitor (800x600 or better).

ModelMaker uses some controls from the microsoft COMCTL32.DLL.
In order to avoid stability problems you should have version 4.72
(or newer) installed. An update for COMCTL32.DLL can be achieved at

http://www.microsoft.com/msdn/downloads/files/40comupd.htm

------------------------------------------------------------------------------
 4. UPGRADING
------------------------------------------------------------------------------

Users of ModelMaker 3.x and 4.0 build 83 or older
-------------------------------------------------
ModelMaker 4.0 reads all models saved with previous versions of ModelMaker
but saves them in a format that cannot be read by these older versions.

There are two exceptions to this:

1- ModelMaker 4.0 does NOT read version 3.x diagram files (*.MMD). There's NO
convertor available, but if you have real problems here, contact us.

2- ModelMaker 4.0 does NOT read any model containing contract definitions. If you
have a existing models containing contracts you MUST remove them using 
ModelMaker 3.x before opening them in ModelMaker 4.0. We are working on a
better way supporting contracts.

Therefore: Back up any existing models before you open them in ModelMaker 4.0 if you
still want to use older versions!!!!


Users of ModelMaker 4.0 build 83 or older
-----------------------------------------
The registry base key has been changed from 
..\White Ants\ModelMaker\4.0\..
to
..\Babs\ModelMaker\4.0\..
Use the registry editor (export / import) to copy old settings to the new key
if you don't want your old settings lost.


Users of ModelMaker 3.20 / 3.30
-------------------------------
Remove ModelMaker 3.x or put ModelMaker 4.0 in a new directory
- Replaced the integration units
- Replace UNITJMP.EXE

Users of older versions of ModelMaker
-------------------------------------
If you are using a previous version of ModelMaker, read the 'For users of 
previous versions of ModelMaker' paragraph in the 'Introduction' chapter of the 
user manual.

------------------------------------------------------------------------------
 5. INSTALLATION
------------------------------------------------------------------------------

!!- Be sure to SHUT DOWN Delphi 3.0 BEFORE running set-up.

-   Unpack the archive and run SETUP.EXE. That's all there's to do.

------------------------------------------------------------------------------
6. INTEGRATION WITH DELPHI
------------------------------------------------------------------------------
Although ModelMaker is a stand-alone application and you don't need Delphi to 
run it, some extra features are available when it is integrated with Delphis 
IDE. 

Although it is possible to integrate ModelMaker with Delphi 1, 2 and 3 
at the same time, it is NOT recommended that more of them are running at the 
same time when working with ModelMaker.


Integration with Delphi 3.0
--------------------------------------------------
ModelMaker is integrated with Delphi 3.0 by use of an Add-in expert.
This expert is automatically installed by the setup program.

This expert add some menu items to Delphi's main menu:
- Run ModelMaker, (if not already running)
- Jump to ModelMaker (Ctl+F11), jump to ModelMaker. Note that inside
  MM there is a new command 'Jump to Delphi' also with shortcut Ctl+F11
  which locates the current method in the delphi editor.
- Add to Model, adds the topmost unit in the Delphi editor to the 
  current MM model
- Convert to Model, again takes the file from the topmost editor,
  creates a new model and adds the topmost file to this model.
- Refresh in Model, re-imports the topmost file in the editor in the 
  current MM model
- Convert project to Model, which creates a new model and adds all files
  in the current Delphi project to the new model.

Note that the expert will first SAVE changes in Delphi before the actual
command is performed. Therefore these commands won't work on read-only 
(project) files.

Users of previous versions of ModelMaker may remove the tool UNITJMP. 
The expert completely replaces this tool.

Any suggestions for further improvement of the expert are welcome.


Integration with Delphi 1.0 and/or 2.0
--------------------------------------------------

Integration with D1 / D2 consists of two aspects:
1. Installing the unit MMINTF.PAS (in direcory [installdir]\mmintf
   in your component library. Installing this unit will enable ModelMaker to:
   - Automatically update Delphi's code editor whenever a source file is 
     (re)generated.
   - Access Delphi's on-line context sensitive help.
   - Call Delphi's 'Syntax Check' menu from within ModelMaker.
2. Installing the utility UNITJMP.EXE in your Delphi Tools menu. 
   Installing this utility will enable you to jump from Delphis code editor 
   to the corresponding code in ModelMaker.

Installing MMINTF.PAS for Delphi 1
----------------------------------

Install the unit MMINTF.PAS:
1. Start Delphi.
2. Add the unit to your component library, just like you would do with any 
   other component (refer to your Delphi user manual).
   Select menu 'Options|Install Components', select Add and browse to find 
   the unit [installdir]\MMINTF.MMINTF.PAS
3. Don't be surprised that you won't see any changes in your VCL component 
   palette after Delphi recompiled the VCL: there is no new component 
   installed, just an integration link, which is not a component.


Installing MMINTF.PAS for Delphi 2
----------------------------------

To install the unit MMINTF.PAS:
1. Start Delphi.
2. Add the unit to your component library, just like you would do with any 
   other component (refer to your Delphi user manual).
   Select menu 'Component|Install', select Add and browse to find the unit 
   [installdir]\mmintf\MMINTF.PAS.
3. Don't be surprised that you won't see any changes in your VCL component 
   palette after Delphi recompiled the VCL: there is no new component 
   installed, just an integration link, which is not a component.

It is possible to install MMINTF.PAS in both Delphi 1 and 2 at the 
same time. In that case, copy the integration units to a new folder, from 
which you install the MMINTF.PAS, to avoid Delphi complaining about errors 
due to incompatibility in .DCU files.

Installing UNITJMP.EXE as a tool (Delphi1 and 2)
----------------------------------------------------------------

To install the UNITJMP.EXE utility (refer to your Delphi user manual):
1. Start Delphi.
2. In Delphi 1.0 select menu 'Options|Tools...'.
   In Delphi 2.0 select menu 'Tools|Tools...'.
   In Delphi 3.0 select menu 'Tools|Configure Tools...'.
3. Select 'Add' and add a new tool, title it 'Jump &to MM', (Delphi 1.0) or 
   'Jump to &MM' (Delphi 2.0 and 3.0).
4. Select 'Browse' to locate the UNITJMP.EXE file in the \MMWIN\BIN folder.
5. Select 'Macros' to pass the parameters '$ROW $EDNAME', the space is 
   required, the single quotes should not be entered.
6. Select OK and Close to add this utility.

Now you'll be able to jump from Delphis code editor to ModelMaker (which 
should be running) by pressing Alt+T+T (Delphi 1.0) or Alt+T+M (Delphi 2.0
or 3.0).

UnitJump can be installed more than once as a tool, each time passing different
parameters. 

For automatic refreshing of the top most file in the IDE editor, 
pass parameters '-1 $EDNAME'
See the version 3.30 addendum for more information.

To add the topmost in the delphi editor to the current model, 
use parameters '-3 $EDNAME'

To create a new model and add the topmost in the delphi editor to this model, 
use parameters '-2 $EDNAME'

------------------------------------------------------------------------------
WARNING
------------------------------------------------------------------------------

Be very carefull when using the REFRESH option in functionality UnitJump!!!
This process can be quite destructive if used in the wrong way.
Make backups, know what you're doing or don't use it.
See the 'version 3.30 addendum or version 4.0 addendum' for more information.


------------------------------------------------------------------------------
 6. GETTING HELP AND GIVING FEEDBACK
------------------------------------------------------------------------------

Check our website www.modelmaker.demon.nl for more information.

We will maintain a 'Frequently Asked Questions' (FAQ) page at our 
website. Please check this first.

For technical and commercial questions please e-mail us at:

  support@modelmaker.demon.nl

We will be very pleased if you send us a message about your experiences using 
ModelMaker. Doing so will help us to improve to your needs.
Also ideas for future releases are welcome.

------------------------------------------------------------------------------
 7. HISTORY
------------------------------------------------------------------------------

v4.0.0 build 109
----------------
First upgrade.
- New D3 expert and D1/D2 integration units
- COMCTL32.DLL related bugs solved (unittree-view)
- Resource leaks solved (code editor) which caused performance degradation.
- Next / previous difference in Difference View added
- Minor bugs solved

v4.0.0 build 87
---------------
First ModelMaker 4.0 commercial release

v.4.0.0 build 85
----------------
First demo ModelMaker 4.0 release

v4.0.0 build 41..83
-------------------
Beta 1 and 2 releases of ModelMaker 4.0

------------------------------------------------------------------------------
 8. KNOWN BUGS AND WORKAROUNDS
------------------------------------------------------------------------------
Known bugs (B) and their workarounds (W).

-none

