
RELEASE NOTES
-------------

This README describes some specific details for running MICO under
Windows using the Visual-C++ compiler from Microsoft. Beware that the
port isn't finished yet. See STATUS QUO below.


PREREQUISITS
------------

You will need Visual-C++ 5.0 Service Pack 3 to compile MICO for
Windows. Note that without Service Pack 3 (Microsoft terminology for
bug fixes), you won't be able to compile the sources. Although MICO
should run under Windows 95, the Makefiles make use of some features
only found in NT's shell cmd.exe. Therefore you have to compile MICO
under NT. You don't need flex and bison; the MICO sources already
contain the files generated by these tools.

SP3 is available from:
http://www.microsoft.com/msdownload/vs97sp/full.asp


HOW TO INSTALL THE SOURCES
--------------------------

Unzip the files at any location. You do not need to run the configure
script (which would be pretty useless anyways).


HOW TO COMPILE
--------------

Simply change to the directory where you have unzipped the
MICO sources and type:

nmake /f Makefile.win32

this will build all the necessary DLLs and executables in a
subdirectory called "win32-bin", which will be created during the make
process. You should modify the PATH environment variable. If, for
example, the MICO sources were unziped in C:\temp\mico, then type the
following:

PATH C:\temp\mico\win32-bin;%PATH%

Next cd to mico\test\dii and type

nmake /f Makefile.win32

this will build two executables: diiclient.exe and diiserver.exe (for
comments on these executables see below). Note that not all the
Makefiles are in place yet!


STATUS
------

All the major directories compile with no problems (i.e. orb, idl, ir
and imr).

Some notes:

- Whenever I made some changes, I inserted a #ifdef _WINDOWS
  which makes it easy to trace down the locations where I made
  changes.

- I didn't use MiniSTL. VC++ had serious problems with it.

- To run diiclient and diiserver, do the following:
  Change directory to mico\test\dii and run:
    diiserver.exe -ORBIIOPAddr inet:127.0.0.1:4444
  in one shell, and then
    diiclient.exe -ORBBindAddr inet:127.0.0.1:4444
  in another shell.

- all other directories (i.e. test, auxdir, tools, coss) are
  not yet ported to Windows.

- we should make a new demo in mico/demo/mfc which simply represents
  a ported version of mico/demo/qtdemo


HELP
----

Feel free to send comments, patches, or whatever over the mailing list!
