 This is README file for CIM 3.33 port for Win 95/NT under GNU-C 2.8.1 Mingw32
                     (ported by Petr Novak 2000)
------------------------------------------------------------------------------
* If you want to install cim, read 'Install.txt' file.

* If you want to get overview how to use cim, read 'doc\Cim-guide.htm'

* If you want to use class Terminal (ported from PC-Simula) see 'doc\terminal\.'
-------------------------------------------------------------------------------

Problems with intalation & bugs
===============================

* When any problems with instalation or bug appears, please write to:
   petr-novak@volny.cz

Simula notes:
=============

* It is possible to specify the parameters in formal part. E.g.:
    procedure Myproc (integer a, name: real b, boolean procedure p());
    begin ... end;

* External declaration should reference atribute file name (without extension)
  only if filename and declarated name differs.

   E.g. class declaration:  class My_great_class begin ....
        source file:        My_class.sim
        produced atr file:  My_class.atr
        External declar.:   external class My_great_class = "My_class";

* Directive lines:
  - Both # and % could be used for macro processor commands and comments.
  - Both 'include' and 'insert' could be used to insert file.

* You can use C-like comments /* my comment */ in your simula source.

Compilation info:
=================
 
* Differences from official 'cim' options:

  -b flags | --cflags=flags       flags for c-compiler
  -B flags | --ldflags=flags      flags for linker
  -C compiler                     define compiler
  -P | --only-link                only link (don't do sim->c, c->o)
  -d                              same for .c but differently for .atr files:
                                   (atr file is changed only when necessary)

* Make your .exe smaller !!! Run: 'strip myprg.exe'
  (Compiled exe code contains debuging info. This will clean the info.)

* Using 'make' utility from this package:

   !!! dont't forget to include these 2 lines at the begining of your Makefile:

  Path=${PATH}
  SHELL=${COMSPEC}

  Look at the 'doc\Makefile' example.

* Used C compiler:
   This port uses stripped GNU-C 2.8.1 Mingw32.
   If you want to have full version of C-compiler, help files, utilities,
   look at the web site.

* Linking Simula with your C-libraries:
   Mapping input parameters and return value for external procedures:

  integer, short integer -> long
  boolean -> char
  real -> double
  text -> char *
    If used in input parameter:
      points to start-char in 'main', be careful !!! it doesn't strip 
      the text to its actual legth. The whole main is nul terminated,
      thus you should give actual text length and text start
      as an extra parameter.
    If used in return value:
      use C-like string that is automaticly converted to Simula text.
      
  Non-simple type or non-value paramaters -> void *.
  proper procedures are mapped like: void procedure (.....). 

------------------------------------------------------------------------------
