Welcome to ILU 2.0 Alpha 7 for WIN 32.

This .ZIP file contains the Alpha 7 distribution of ILU 2.0.  Because of some last minute
problems, the WIN16 libraries are not enclosed.  As soon as they are working, we'll update the
FTP site with a new .ZIP file.

Also, future releases will have more examples that run under Windows.

Besides the libraries, this .ZIP file also contains the ILU manual in HTML and Postscript
format.  The Postscript version can be viewed and printed with Ghostscript.

If you have any problems to report, please send e-mail to ilu-bugs@parc.xerox.com.

Here are some VERY important notes to remember.  These steps are documented in the ILU manual,
but there are repeated here because 1) no one ever reads the manual ;), and 2) almost every
problem encountered with ILU on Windows is because these steps aren't followed.

1)  Before building any of the examples (either test1 or timeit), you MUST run the stubbers
or the make process will abort with "don't know how to make timeit-surrogate.c" (or some
other .c file).  In other words, to build timeit, type:

c-stubber timeit.isl

before using nmake to build timeit.exe.  Similarly, for test1, type

c-stubber test1.isl test2.isl test3.isl (to generate C stubs for the C version)
c++-stubber test1.isl test2.isl test3.isl (to generate C++ stubs for the C++ version)

Obviously, if you are only going to build the C version of test1, you don't need to run the
C++ stubber.

2)  However, BEFORE running the stubbers, you need to set some environment variables, or the
stubbers won't be able to find some necessary files.  Here are the variables and their values
(assuming ILU is installed on D:\ILUWIN20):

set PATH=d:\iluwin20\bin;%PATH%
set INCLUDE=d:\iluwin20\include;%INCLUDE%
set LIB=d:\iluwin20\lib;%LIB%
set ILU_PATH=.;d:\iluwin20\interfaces
set ILU_BINDING_DIRECTORY=d:\iluwin20\bindings

ILU_PATH is used by the stubbers to locate .ISL files that are referenced.  The "." ensures
that the current directory is searched.

ILU_BINDING_DIRECTORY is used to allow clients and servers to find each other.  If it is
not set, then the default value (\ilu\interfaces) is used, which is probably not right for
your machine.  Set it to a directory you know exists; failure to do so will cause "Unable to
publish object" errors, or clients that can't find servers, even though the server says it is
ok.  Most importantly, make sure both the client and server can see the value; set it globally,
or set it in both sessions before executing each program.

3) If you build and execute the examples and they just don't work, try setting ILU_DEBUG=ALL.
You'll get a LOT of output, and in that output is the reason the example isn't working.

See the ILU manual for detailed explanations of all this.

Mark Davidson

