Installing the new Clean IDE on a Clean 1.3.2 system

The new Clean IDE as distributed is designed to cooperate with
the upcoming Clean 1.3.3 release. Due to the large demand this
version has now been made available seperately so that people
can already make use of the new IDE without having to wait for
Clean 1.3.3. However this does mean that some default settings
of the IDE have to be adjusted. We will guide you through this
process using one of the 0.8 I/O library examples.

1) Backup your existing Clean installation.

2) Rename the existing CleanIDE.exe to oldCleanIDE.exe.
   Similarly for the change_registry and remove_registry
   applications.

3) Install the contents of the CleanIDE zip archive into your
   existing Clean directory. If you plan to continue using the
   old Clean IDE as well ase use the new IDE then you can
   proceed to the next step. Otherwise you can move the cocl and
   cg executables to the newly added tools subdirectory.

4) If you want to use the new IDE as your default Clean environ-
   ment and want it to automatically launch when double-clicking
   Clean projects or modules you can run the newly installed ver-
   sion of the change_registry application. Note that this will
   also add some icons for commonly used Clean file types but
   that these will probably only become visible the next time you
   start up your Windows system.

5) Startup the new CleanIDE application.

6) Select New... from the Environment menu and the name the new
   environment IO 0.8 Examples. A dialogue box will appearing
   allowing you to adjust various settings for the newly created
   environment. Initially the Tools panel wil be visible. If you
   moved the cg and cocl applications to the tools subdirectory
   then you only need to adjust the ABC-version to 917 in the Tools
   pane, otherwise you also need to adjust their locations by
   removing the 'tools\' prefix from the Compiler and Generator
   settings.

7) Now move to the Paths pane of the Environment dialogue. Here
   you need to add two paths. Press the Append... button and first
   locate the 'IOInterface 0.8.1' directory and add it. Then do
   the same for the 'IO Examples 0.8\IO Utilities' directory.

8) You are now finished with the environment dialogue. Press the
   Save button which will close the dialogue box, save the newly
   created environment, and add it to the list of available
   environments in the Environments menu.

9) We are now ready for our first project. First open the main
   module for one of the IO 0.8 examples, that is select Open...
   from the File menu, and navigate to one of the main .icl
   modules, for example LifeGameExample.icl in the Life subdirectory
   of the IO Examples 0.8 folder. Select it and press the Open...
   button.

10) You will now see the module contents in an editor window
    (note the syntax colouring!). Now select New Project... from
    the File menu. This wil present you with a dialogue box allowing
    you to set a name and location for the new project. It is
    easiest to just use the default suggestions and press Save. Now
    make sure that the proper environment is active in the Environment
    menu. Your newly added IO 0.8 Examples environment should be
    active (marked with a check mark), if it isn't then make it the
    active environment by selecting it in the Environment menu.

11) The next step is to modify some of the options for our newly
    created project. Select Project Options... from the Project
    menu. In the Application panel set the Console type to No Console
    since Life is has its own user interface and does not require a
    console. Now move to the Profiling panel and select No Time Profiling
    (or Time Profiling and Stack Trace). This is because Stack Trace only
    is only available with the upcoming Clean 1.3.3 release, just as the
    Heap Profiling option in the same panel.

12) You can now leave the Project Options dialogue by pressing OK.

13) Generate and launch the Life example program by selecting Update
    and Run from the Project menu. If all went well then you are now
    able to play Life!

For more information read the manual.pdf distributed with the new
CleanIDE. If you still have questions or problems then please contact
clean@cs.kun.nl If you have bugs to report or suggestions for improvement
then also send these to clean@cs.kun.nl

Good Luck!
