

   WELCOME
----------

Welcome to the Windows 95 distribution of Clean 1.2.3 which includes the
0.8 version of the Clean I/O library.

This release runs only on Windows 95. Windows NT support is in the works
(Windows 3.1 will not be supported, not even with Win32s).

This zip file contains

-  The Clean compiler  (cocl.exe and cg.exe), which is called from
-  The Clean Integrated Development Environment (CleanIDE.exe) with
   its help file ('Clean Help').
-  The standard library for arthmetic, string and list manipulation,
   file I/O, etc. (StdEnv)
-  The I/O library for graphical user interface applications
   (IOInterface). Note that there are some small differences between the 
   Windows 95 version and the Macintosh version of the I/O library. 
   See below.
-  Several example programs, including examples of graphical user
   interfaces (Examples\Small Demos & Examples\IOExamples).
   


   INSTALLATION
---------------

Installation should be simple:

-  Unzip 'Clean123w95.zip' to any destination you like.
   Be sure to use an unzipper program that understands long
   file names. Also, extract the files WITH the directory
   structure intact.  
   This will create a 'Clean' folder.

-  In the 'Clean' folder find, and execute the program 'CleanIDE'.
   This starts the special Clean development environment.

-  You'll want to use the StdEnv library, so you have to set a
   path to it. From the 'Options' menu, select 'Paths...'. This
   opens the paths dialog box.
   
-  Press the 'Add' button below the words 'Default Paths'. This
   opens the standard windows 95 file selector dialog box. Use it
   to select a file (any file will do) in the 'StdEnv' directory.
   Dismiss the dialog by clicking 'OK'. The path to the standard
   library will be added to the default paths.

-  Repeat this procedure to add the 'IOInterface' directory to the
   default paths.



   COMPILING I/O EXAMPLES
-------------------------

Now you can try to compile one of the example programs.

-  From within the IDE, use the 'Open...' item in the 'File' menu
   to open 'Mines.icl'. You can find Mines in the IOExamples 
   directory. 'Mines.icl' is the top-most implementation module
   of the Mines example.

-  Make a project out of 'Mines' by selecting 'New Project' from the 
   Project menu. This creates a new file 'Mines.prj' that you can 
   use later on to open the project and all associated files.

-  Mines uses files from the IO Utilities directory (also found in the
   IOExamples directory). You'll have to set a path to this directory.
   Use the 'Paths...' command in the 'Options' menu, but this time add
   the path to the Project Paths.

-  By default, Clean applications create a console window (kinda like the 
   MS-DOS window) for their output. Since Mines is a GUI program which
   creates its own windows, you don't want a console for Mines. Disable
   the console creation by selecting "Application..." from the Options
   menu and selecting the "No Console" radio button in the dialog that
   appears. 

-  From the 'Commands' menu, select 'Run "Mines"'. The IDE will now
   build the application. It will launch 'mines.exe' automatically.

-  Have fun. Be sure to report any bugs you find via email to
   clean@cs.kun.nl

Use the same procedure to compile all other IO example programs. 
You can recognize the top-level implementation module by the fact that
it doesn't have a corresponding '.dcl' file.



   DIFFERENCES BETWEEN THE WINDOWS AND MACINTOSH VERSION OF THE I/O LIB
-----------------------------------------------------------------------

1.  Of the nine pen modes defined in deltaPicture only CopyMode, XorMode
    and HiliteMode are implemented in the Windows 95 version of the I/O
    library.

2.  Pen patterns are not implemented in the Windows 95 version of the I/O
    library.

3.  The function NestIO in deltaEventIO does not exist in the windows 95
    version of the I/O library

4.  The functions SelectInputFile and SelectOutputFile (from 
    deltaFileSelect) have had their types changed. Instead of requiring
    and returning a 'Files' parameter, they now require and return the
    program state. This is also true in the latest version of the
    Macintosh I/O library.

5.  The function OpenNotice now requires and returns an additional
    parameter: the program state. This is also true in the latest version
    of the Macintosh I/O library.



   ONLINE HELP AND DOCUMENTATION
--------------------------------

The Clean System application contains an on-line help facility, which
will give you more information about Concurrent Clean and the Clean
System.

Documentation can be found in the directory

        ftp://ftp.cs.kun.nl/pub/Clean/Clean12/doc

There is a mailing list for discussions about Clean.  Send mail to
"clean-request@cs.kun.nl" with the word "subscribe" in the Subject: field
to join this mailing list.

We also have some pages on the World Wide Web, with documentation, manuals,
papers and versions of Clean for other platforms:

        http://www.cs.kun.nl/~clean/



   PLEASE REPORT BUGS
---------------------


If you find any bugs, have questions, comments or suggestions you can
reach us at:

        clean@cs.kun.nl

